doc.go 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153
  1. // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
  2. // Package codepipeline provides the client and types for making API
  3. // requests to AWS CodePipeline.
  4. //
  5. // Overview
  6. //
  7. // This is the AWS CodePipeline API Reference. This guide provides descriptions
  8. // of the actions and data types for AWS CodePipeline. Some functionality for
  9. // your pipeline is only configurable through the API. For additional information,
  10. // see the AWS CodePipeline User Guide (http://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html).
  11. //
  12. // You can use the AWS CodePipeline API to work with pipelines, stages, actions,
  13. // and transitions, as described below.
  14. //
  15. // Pipelines are models of automated release processes. Each pipeline is uniquely
  16. // named, and consists of stages, actions, and transitions.
  17. //
  18. // You can work with pipelines by calling:
  19. //
  20. // * CreatePipeline, which creates a uniquely-named pipeline.
  21. //
  22. // * DeletePipeline, which deletes the specified pipeline.
  23. //
  24. // * GetPipeline, which returns information about the pipeline structure
  25. // and pipeline metadata, including the pipeline Amazon Resource Name (ARN).
  26. //
  27. // * GetPipelineExecution, which returns information about a specific execution
  28. // of a pipeline.
  29. //
  30. // * GetPipelineState, which returns information about the current state
  31. // of the stages and actions of a pipeline.
  32. //
  33. // * ListPipelines, which gets a summary of all of the pipelines associated
  34. // with your account.
  35. //
  36. // * ListPipelineExecutions, which gets a summary of the most recent executions
  37. // for a pipeline.
  38. //
  39. // * StartPipelineExecution, which runs the the most recent revision of an
  40. // artifact through the pipeline.
  41. //
  42. // * UpdatePipeline, which updates a pipeline with edits or changes to the
  43. // structure of the pipeline.
  44. //
  45. // Pipelines include stages. Each stage contains one or more actions that must
  46. // complete before the next stage begins. A stage will result in success or
  47. // failure. If a stage fails, then the pipeline stops at that stage and will
  48. // remain stopped until either a new version of an artifact appears in the source
  49. // location, or a user takes action to re-run the most recent artifact through
  50. // the pipeline. You can call GetPipelineState, which displays the status of
  51. // a pipeline, including the status of stages in the pipeline, or GetPipeline,
  52. // which returns the entire structure of the pipeline, including the stages
  53. // of that pipeline. For more information about the structure of stages and
  54. // actions, also refer to the AWS CodePipeline Pipeline Structure Reference
  55. // (http://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-structure.html).
  56. //
  57. // Pipeline stages include actions, which are categorized into categories such
  58. // as source or build actions performed within a stage of a pipeline. For example,
  59. // you can use a source action to import artifacts into a pipeline from a source
  60. // such as Amazon S3. Like stages, you do not work with actions directly in
  61. // most cases, but you do define and interact with actions when working with
  62. // pipeline operations such as CreatePipeline and GetPipelineState. Valid action
  63. // categories are:
  64. //
  65. // * Source
  66. //
  67. // * Build
  68. //
  69. // * Test
  70. //
  71. // * Deploy
  72. //
  73. // * Approval
  74. //
  75. // * Invoke
  76. //
  77. // Pipelines also include transitions, which allow the transition of artifacts
  78. // from one stage to the next in a pipeline after the actions in one stage complete.
  79. //
  80. // You can work with transitions by calling:
  81. //
  82. // * DisableStageTransition, which prevents artifacts from transitioning
  83. // to the next stage in a pipeline.
  84. //
  85. // * EnableStageTransition, which enables transition of artifacts between
  86. // stages in a pipeline.
  87. //
  88. // Using the API to integrate with AWS CodePipeline
  89. //
  90. // For third-party integrators or developers who want to create their own integrations
  91. // with AWS CodePipeline, the expected sequence varies from the standard API
  92. // user. In order to integrate with AWS CodePipeline, developers will need to
  93. // work with the following items:
  94. //
  95. // Jobs, which are instances of an action. For example, a job for a source action
  96. // might import a revision of an artifact from a source.
  97. //
  98. // You can work with jobs by calling:
  99. //
  100. // * AcknowledgeJob, which confirms whether a job worker has received the
  101. // specified job,
  102. //
  103. // * GetJobDetails, which returns the details of a job,
  104. //
  105. // * PollForJobs, which determines whether there are any jobs to act upon,
  106. //
  107. //
  108. // * PutJobFailureResult, which provides details of a job failure, and
  109. //
  110. // * PutJobSuccessResult, which provides details of a job success.
  111. //
  112. // Third party jobs, which are instances of an action created by a partner action
  113. // and integrated into AWS CodePipeline. Partner actions are created by members
  114. // of the AWS Partner Network.
  115. //
  116. // You can work with third party jobs by calling:
  117. //
  118. // * AcknowledgeThirdPartyJob, which confirms whether a job worker has received
  119. // the specified job,
  120. //
  121. // * GetThirdPartyJobDetails, which requests the details of a job for a partner
  122. // action,
  123. //
  124. // * PollForThirdPartyJobs, which determines whether there are any jobs to
  125. // act upon,
  126. //
  127. // * PutThirdPartyJobFailureResult, which provides details of a job failure,
  128. // and
  129. //
  130. // * PutThirdPartyJobSuccessResult, which provides details of a job success.
  131. //
  132. // See https://docs.aws.amazon.com/goto/WebAPI/codepipeline-2015-07-09 for more information on this service.
  133. //
  134. // See codepipeline package documentation for more information.
  135. // https://docs.aws.amazon.com/sdk-for-go/api/service/codepipeline/
  136. //
  137. // Using the Client
  138. //
  139. // To contact AWS CodePipeline with the SDK use the New function to create
  140. // a new service client. With that client you can make API requests to the service.
  141. // These clients are safe to use concurrently.
  142. //
  143. // See the SDK's documentation for more information on how to use the SDK.
  144. // https://docs.aws.amazon.com/sdk-for-go/api/
  145. //
  146. // See aws.Config documentation for more information on configuring SDK clients.
  147. // https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
  148. //
  149. // See the AWS CodePipeline client CodePipeline for more
  150. // information on creating client for this service.
  151. // https://docs.aws.amazon.com/sdk-for-go/api/service/codepipeline/#New
  152. package codepipeline