capo-cloudcontrol 0.4.0__tar.gz → 0.5.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {capo_cloudcontrol-0.4.0/src/capo_cloudcontrol.egg-info → capo_cloudcontrol-0.5.0}/PKG-INFO +1 -1
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/pyproject.toml +1 -1
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_services/async_cloud_control.py +21 -21
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_services/cloud_control.py +21 -21
- capo_cloudcontrol-0.5.0/src/capo_cloudcontrol/types/create_resource_input.py +62 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/create_resource_output.py +1 -1
- capo_cloudcontrol-0.5.0/src/capo_cloudcontrol/types/delete_resource_input.py +62 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/delete_resource_output.py +1 -1
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/get_resource_input.py +2 -2
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/list_resources_input.py +1 -1
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/progress_event.py +2 -2
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/resource_description.py +1 -1
- capo_cloudcontrol-0.5.0/src/capo_cloudcontrol/types/update_resource_input.py +70 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/update_resource_output.py +1 -1
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0/src/capo_cloudcontrol.egg-info}/PKG-INFO +1 -1
- capo_cloudcontrol-0.4.0/src/capo_cloudcontrol/types/create_resource_input.py +0 -62
- capo_cloudcontrol-0.4.0/src/capo_cloudcontrol/types/delete_resource_input.py +0 -62
- capo_cloudcontrol-0.4.0/src/capo_cloudcontrol/types/update_resource_input.py +0 -70
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/LICENSE +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/README.md +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/setup.cfg +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/__init__.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_async.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_auth/_identity.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_auth/_providers.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_auth/_signers.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_auth/_sigv4.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_auth/_zapros_handler.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_body.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_iter.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/cancel_resource_request.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/create_resource.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/delete_resource.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/get_resource.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/get_resource_request_status.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/list_resource_requests.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/list_resources.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_operations/cloud_api_service/update_resource.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_pagination.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_protocol/__init__.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_protocol/errors.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_protocol/eventstream.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_protocol/serialize.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_protocol/xml.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_rule_engine/__init__.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_rule_engine/_aws_partition.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_rule_engine/_endpoint_rule_set.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_rule_engine/_endpoint_runtime.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_services/_aws_config.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_services/_pipeline.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/__init__.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/_base.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/already_exists_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/client_token_conflict_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/concurrent_modification_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/concurrent_operation_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/general_service_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/handler_failure_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/handler_internal_failure_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/invalid_credentials_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/invalid_request_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/network_failure_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/not_stabilized_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/not_updatable_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/private_type_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/request_token_not_found_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/resource_conflict_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/resource_not_found_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/service_internal_error_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/service_limit_exceeded_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/throttling_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/type_not_found_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/errors/unsupported_action_exception.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/py.typed +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/_prelude/blob.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/_prelude/timestamp.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/cancel_resource_request_input.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/cancel_resource_request_output.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/client_token.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/error_message.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/get_resource_output.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/get_resource_request_status_input.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/get_resource_request_status_output.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/handler_error_code.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/handler_next_token.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/hook_failure_mode.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/hook_invocation_point.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/hook_progress_event.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/hook_status.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/hook_type_arn.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/hooks_progress_event.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/identifier.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/list_resource_requests_input.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/list_resource_requests_output.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/list_resources_output.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/max_results.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/next_token.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/operation.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/operation_status.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/operation_statuses.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/operations.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/patch_document.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/properties.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/request_token.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/resource_descriptions.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/resource_request_status_filter.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/resource_request_status_summaries.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/role_arn.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/status_message.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/timestamp.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/type_name.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/types/type_version_id.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol.egg-info/SOURCES.txt +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol.egg-info/dependency_links.txt +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol.egg-info/requires.txt +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol.egg-info/top_level.txt +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/tests/test_body.py +0 -0
- {capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/tests/test_sigv4.py +0 -0
|
@@ -161,7 +161,7 @@ class AsyncCloudControlClient:
|
|
|
161
161
|
*,
|
|
162
162
|
config_overrides: Optional[AsyncCloudControlClientConfig] = None,
|
|
163
163
|
) -> "capo_cloudcontrol.types.cancel_resource_request_output.CancelResourceRequestOutput":
|
|
164
|
-
|
|
164
|
+
"""<p>Cancels the specified resource operation request. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html#resource-operations-manage-requests-cancel">Canceling resource operation requests</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>Only resource operations requests with a status of <code>PENDING</code> or <code>IN_PROGRESS</code> can be canceled.</p>
|
|
165
165
|
|
|
166
166
|
Args:
|
|
167
167
|
request_token: <p>The <code>RequestToken</code> of the <code>ProgressEvent</code> object returned by the resource operation request.</p>
|
|
@@ -214,14 +214,14 @@ class AsyncCloudControlClient:
|
|
|
214
214
|
"capo_cloudcontrol.types.client_token.ClientToken"
|
|
215
215
|
] = None,
|
|
216
216
|
) -> "capo_cloudcontrol.types.create_resource_output.CreateResourceOutput":
|
|
217
|
-
|
|
217
|
+
"""<p>Creates the specified resource. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html">Creating a resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>After you have initiated a resource creation request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> type returned by <code>CreateResource</code>.</p>
|
|
218
218
|
|
|
219
219
|
Args:
|
|
220
220
|
type_name: <p>The name of the resource type.</p>
|
|
221
221
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
222
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
223
|
-
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href
|
|
224
|
-
desired_state: <p>Structured data format representing the desired state of the resource, consisting of that resource's properties and their desired values.</p> <note> <p>Cloud Control API currently supports JSON as a structured data format.</p> </note> <p>Specify the desired state as one of the following:</p> <ul> <li> <p>A JSON blob</p> </li> <li> <p>A local path containing the desired state in JSON data format</p> </li> </ul> <p>For more information, see <a href
|
|
222
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
223
|
+
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
224
|
+
desired_state: <p>Structured data format representing the desired state of the resource, consisting of that resource's properties and their desired values.</p> <note> <p>Cloud Control API currently supports JSON as a structured data format.</p> </note> <p>Specify the desired state as one of the following:</p> <ul> <li> <p>A JSON blob</p> </li> <li> <p>A local path containing the desired state in JSON data format</p> </li> </ul> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html#resource-operations-create-desiredstate">Composing the desired state of the resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>For more information about the properties of a specific resource, refer to the related topic for the resource in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Resource and property types reference</a> in the <i>CloudFormation Users Guide</i>.</p>
|
|
225
225
|
|
|
226
226
|
Raises:
|
|
227
227
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
|
@@ -296,14 +296,14 @@ class AsyncCloudControlClient:
|
|
|
296
296
|
"capo_cloudcontrol.types.client_token.ClientToken"
|
|
297
297
|
] = None,
|
|
298
298
|
) -> "capo_cloudcontrol.types.delete_resource_output.DeleteResourceOutput":
|
|
299
|
-
|
|
299
|
+
"""<p>Deletes the specified resource. For details, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-delete.html">Deleting a resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>After you have initiated a resource deletion request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> returned by <code>DeleteResource</code>.</p>
|
|
300
300
|
|
|
301
301
|
Args:
|
|
302
302
|
type_name: <p>The name of the resource type.</p>
|
|
303
303
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
304
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
305
|
-
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href
|
|
306
|
-
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href
|
|
304
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
305
|
+
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
306
|
+
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
307
307
|
|
|
308
308
|
Raises:
|
|
309
309
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
|
@@ -375,13 +375,13 @@ class AsyncCloudControlClient:
|
|
|
375
375
|
] = None,
|
|
376
376
|
role_arn: Optional["capo_cloudcontrol.types.role_arn.RoleArn"] = None,
|
|
377
377
|
) -> "capo_cloudcontrol.types.get_resource_output.GetResourceOutput":
|
|
378
|
-
|
|
378
|
+
"""<p>Returns information about the current state of the specified resource. For details, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-read.html">Reading a resource's current state</a>.</p> <p>You can use this action to return information about an existing resource in your account and Amazon Web Services Region, whether those resources were provisioned using Cloud Control API.</p>
|
|
379
379
|
|
|
380
380
|
Args:
|
|
381
381
|
type_name: <p>The name of the resource type.</p>
|
|
382
382
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
383
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
384
|
-
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href
|
|
383
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
384
|
+
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
385
385
|
|
|
386
386
|
Raises:
|
|
387
387
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
|
@@ -443,7 +443,7 @@ class AsyncCloudControlClient:
|
|
|
443
443
|
*,
|
|
444
444
|
config_overrides: Optional[AsyncCloudControlClientConfig] = None,
|
|
445
445
|
) -> "capo_cloudcontrol.types.get_resource_request_status_output.GetResourceRequestStatusOutput":
|
|
446
|
-
|
|
446
|
+
"""<p>Returns the current status of a resource operation request. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html#resource-operations-manage-requests-track">Tracking the progress of resource operation requests</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
447
447
|
|
|
448
448
|
Args:
|
|
449
449
|
request_token: <p>A unique token used to track the progress of the resource operation request.</p> <p>Request tokens are included in the <code>ProgressEvent</code> type returned by a resource operation request.</p>
|
|
@@ -491,7 +491,7 @@ class AsyncCloudControlClient:
|
|
|
491
491
|
"capo_cloudcontrol.types.resource_request_status_filter.ResourceRequestStatusFilter"
|
|
492
492
|
] = None,
|
|
493
493
|
) -> "capo_cloudcontrol.types.list_resource_requests_output.ListResourceRequestsOutput":
|
|
494
|
-
|
|
494
|
+
"""<p>Returns existing resource operation requests. This includes requests of all status types. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html#resource-operations-manage-requests-list">Listing active resource operation requests</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <note> <p>Resource operation requests expire after 7 days.</p> </note>
|
|
495
495
|
|
|
496
496
|
Args:
|
|
497
497
|
max_results: <p>The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a <code>NextToken</code> value that you can assign to the <code>NextToken</code> request parameter to get the next set of results.</p> <p>The default is <code>20</code>.</p>
|
|
@@ -576,12 +576,12 @@ class AsyncCloudControlClient:
|
|
|
576
576
|
"capo_cloudcontrol.types.properties.Properties"
|
|
577
577
|
] = None,
|
|
578
578
|
) -> "capo_cloudcontrol.types.list_resources_output.ListResourcesOutput":
|
|
579
|
-
|
|
579
|
+
"""<p>Returns information about the specified resources. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-list.html">Discovering resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>You can use this action to return information about existing resources in your account and Amazon Web Services Region, whether those resources were provisioned using Cloud Control API.</p>
|
|
580
580
|
|
|
581
581
|
Args:
|
|
582
582
|
type_name: <p>The name of the resource type.</p>
|
|
583
583
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
584
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
584
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
585
585
|
next_token: <p>If the previous paginated request didn't return all of the remaining results, the response object's <code>NextToken</code> parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object's <code>NextToken</code> parameter. If there are no remaining results, the previous response object's <code>NextToken</code> parameter is set to <code>null</code>.</p>
|
|
586
586
|
max_results: <p>Reserved.</p>
|
|
587
587
|
resource_model: <p>The resource model to use to select the resources to return.</p>
|
|
@@ -695,15 +695,15 @@ class AsyncCloudControlClient:
|
|
|
695
695
|
"capo_cloudcontrol.types.client_token.ClientToken"
|
|
696
696
|
] = None,
|
|
697
697
|
) -> "capo_cloudcontrol.types.update_resource_output.UpdateResourceOutput":
|
|
698
|
-
|
|
698
|
+
"""<p>Updates the specified property values in the resource.</p> <p>You specify your resource property updates as a list of patch operations contained in a JSON patch document that adheres to the <a href="https://datatracker.ietf.org/doc/html/rfc6902"> <i>RFC 6902 - JavaScript Object Notation (JSON) Patch</i> </a> standard.</p> <p>For details on how Cloud Control API performs resource update operations, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html">Updating a resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>After you have initiated a resource update request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> returned by <code>UpdateResource</code>.</p> <p>For more information about the properties of a specific resource, refer to the related topic for the resource in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Resource and property types reference</a> in the <i>CloudFormation Users Guide</i>.</p>
|
|
699
699
|
|
|
700
700
|
Args:
|
|
701
701
|
type_name: <p>The name of the resource type.</p>
|
|
702
702
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
703
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
704
|
-
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href
|
|
705
|
-
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href
|
|
706
|
-
patch_document: <p>A JavaScript Object Notation (JSON) document listing the patch operations that represent the updates to apply to the current resource properties. For details, see <a href
|
|
703
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
704
|
+
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
705
|
+
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
706
|
+
patch_document: <p>A JavaScript Object Notation (JSON) document listing the patch operations that represent the updates to apply to the current resource properties. For details, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html#resource-operations-update-patch">Composing the patch document</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
707
707
|
|
|
708
708
|
Raises:
|
|
709
709
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
{capo_cloudcontrol-0.4.0 → capo_cloudcontrol-0.5.0}/src/capo_cloudcontrol/_services/cloud_control.py
RENAMED
|
@@ -161,7 +161,7 @@ class CloudControlClient:
|
|
|
161
161
|
*,
|
|
162
162
|
config_overrides: Optional[CloudControlClientConfig] = None,
|
|
163
163
|
) -> "capo_cloudcontrol.types.cancel_resource_request_output.CancelResourceRequestOutput":
|
|
164
|
-
|
|
164
|
+
"""<p>Cancels the specified resource operation request. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html#resource-operations-manage-requests-cancel">Canceling resource operation requests</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>Only resource operations requests with a status of <code>PENDING</code> or <code>IN_PROGRESS</code> can be canceled.</p>
|
|
165
165
|
|
|
166
166
|
Args:
|
|
167
167
|
request_token: <p>The <code>RequestToken</code> of the <code>ProgressEvent</code> object returned by the resource operation request.</p>
|
|
@@ -213,14 +213,14 @@ class CloudControlClient:
|
|
|
213
213
|
"capo_cloudcontrol.types.client_token.ClientToken"
|
|
214
214
|
] = None,
|
|
215
215
|
) -> "capo_cloudcontrol.types.create_resource_output.CreateResourceOutput":
|
|
216
|
-
|
|
216
|
+
"""<p>Creates the specified resource. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html">Creating a resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>After you have initiated a resource creation request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> type returned by <code>CreateResource</code>.</p>
|
|
217
217
|
|
|
218
218
|
Args:
|
|
219
219
|
type_name: <p>The name of the resource type.</p>
|
|
220
220
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
221
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
222
|
-
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href
|
|
223
|
-
desired_state: <p>Structured data format representing the desired state of the resource, consisting of that resource's properties and their desired values.</p> <note> <p>Cloud Control API currently supports JSON as a structured data format.</p> </note> <p>Specify the desired state as one of the following:</p> <ul> <li> <p>A JSON blob</p> </li> <li> <p>A local path containing the desired state in JSON data format</p> </li> </ul> <p>For more information, see <a href
|
|
221
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
222
|
+
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
223
|
+
desired_state: <p>Structured data format representing the desired state of the resource, consisting of that resource's properties and their desired values.</p> <note> <p>Cloud Control API currently supports JSON as a structured data format.</p> </note> <p>Specify the desired state as one of the following:</p> <ul> <li> <p>A JSON blob</p> </li> <li> <p>A local path containing the desired state in JSON data format</p> </li> </ul> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html#resource-operations-create-desiredstate">Composing the desired state of the resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>For more information about the properties of a specific resource, refer to the related topic for the resource in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Resource and property types reference</a> in the <i>CloudFormation Users Guide</i>.</p>
|
|
224
224
|
|
|
225
225
|
Raises:
|
|
226
226
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
|
@@ -294,14 +294,14 @@ class CloudControlClient:
|
|
|
294
294
|
"capo_cloudcontrol.types.client_token.ClientToken"
|
|
295
295
|
] = None,
|
|
296
296
|
) -> "capo_cloudcontrol.types.delete_resource_output.DeleteResourceOutput":
|
|
297
|
-
|
|
297
|
+
"""<p>Deletes the specified resource. For details, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-delete.html">Deleting a resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>After you have initiated a resource deletion request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> returned by <code>DeleteResource</code>.</p>
|
|
298
298
|
|
|
299
299
|
Args:
|
|
300
300
|
type_name: <p>The name of the resource type.</p>
|
|
301
301
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
302
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
303
|
-
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href
|
|
304
|
-
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href
|
|
302
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
303
|
+
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
304
|
+
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
305
305
|
|
|
306
306
|
Raises:
|
|
307
307
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
|
@@ -372,13 +372,13 @@ class CloudControlClient:
|
|
|
372
372
|
] = None,
|
|
373
373
|
role_arn: Optional["capo_cloudcontrol.types.role_arn.RoleArn"] = None,
|
|
374
374
|
) -> "capo_cloudcontrol.types.get_resource_output.GetResourceOutput":
|
|
375
|
-
|
|
375
|
+
"""<p>Returns information about the current state of the specified resource. For details, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-read.html">Reading a resource's current state</a>.</p> <p>You can use this action to return information about an existing resource in your account and Amazon Web Services Region, whether those resources were provisioned using Cloud Control API.</p>
|
|
376
376
|
|
|
377
377
|
Args:
|
|
378
378
|
type_name: <p>The name of the resource type.</p>
|
|
379
379
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
380
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
381
|
-
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href
|
|
380
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
381
|
+
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
382
382
|
|
|
383
383
|
Raises:
|
|
384
384
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
|
@@ -439,7 +439,7 @@ class CloudControlClient:
|
|
|
439
439
|
*,
|
|
440
440
|
config_overrides: Optional[CloudControlClientConfig] = None,
|
|
441
441
|
) -> "capo_cloudcontrol.types.get_resource_request_status_output.GetResourceRequestStatusOutput":
|
|
442
|
-
|
|
442
|
+
"""<p>Returns the current status of a resource operation request. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html#resource-operations-manage-requests-track">Tracking the progress of resource operation requests</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
443
443
|
|
|
444
444
|
Args:
|
|
445
445
|
request_token: <p>A unique token used to track the progress of the resource operation request.</p> <p>Request tokens are included in the <code>ProgressEvent</code> type returned by a resource operation request.</p>
|
|
@@ -486,7 +486,7 @@ class CloudControlClient:
|
|
|
486
486
|
"capo_cloudcontrol.types.resource_request_status_filter.ResourceRequestStatusFilter"
|
|
487
487
|
] = None,
|
|
488
488
|
) -> "capo_cloudcontrol.types.list_resource_requests_output.ListResourceRequestsOutput":
|
|
489
|
-
|
|
489
|
+
"""<p>Returns existing resource operation requests. This includes requests of all status types. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-manage-requests.html#resource-operations-manage-requests-list">Listing active resource operation requests</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <note> <p>Resource operation requests expire after 7 days.</p> </note>
|
|
490
490
|
|
|
491
491
|
Args:
|
|
492
492
|
max_results: <p>The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a <code>NextToken</code> value that you can assign to the <code>NextToken</code> request parameter to get the next set of results.</p> <p>The default is <code>20</code>.</p>
|
|
@@ -570,12 +570,12 @@ class CloudControlClient:
|
|
|
570
570
|
"capo_cloudcontrol.types.properties.Properties"
|
|
571
571
|
] = None,
|
|
572
572
|
) -> "capo_cloudcontrol.types.list_resources_output.ListResourcesOutput":
|
|
573
|
-
|
|
573
|
+
"""<p>Returns information about the specified resources. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-list.html">Discovering resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>You can use this action to return information about existing resources in your account and Amazon Web Services Region, whether those resources were provisioned using Cloud Control API.</p>
|
|
574
574
|
|
|
575
575
|
Args:
|
|
576
576
|
type_name: <p>The name of the resource type.</p>
|
|
577
577
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
578
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
578
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
579
579
|
next_token: <p>If the previous paginated request didn't return all of the remaining results, the response object's <code>NextToken</code> parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object's <code>NextToken</code> parameter. If there are no remaining results, the previous response object's <code>NextToken</code> parameter is set to <code>null</code>.</p>
|
|
580
580
|
max_results: <p>Reserved.</p>
|
|
581
581
|
resource_model: <p>The resource model to use to select the resources to return.</p>
|
|
@@ -688,15 +688,15 @@ class CloudControlClient:
|
|
|
688
688
|
"capo_cloudcontrol.types.client_token.ClientToken"
|
|
689
689
|
] = None,
|
|
690
690
|
) -> "capo_cloudcontrol.types.update_resource_output.UpdateResourceOutput":
|
|
691
|
-
|
|
691
|
+
"""<p>Updates the specified property values in the resource.</p> <p>You specify your resource property updates as a list of patch operations contained in a JSON patch document that adheres to the <a href="https://datatracker.ietf.org/doc/html/rfc6902"> <i>RFC 6902 - JavaScript Object Notation (JSON) Patch</i> </a> standard.</p> <p>For details on how Cloud Control API performs resource update operations, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html">Updating a resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>After you have initiated a resource update request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> returned by <code>UpdateResource</code>.</p> <p>For more information about the properties of a specific resource, refer to the related topic for the resource in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Resource and property types reference</a> in the <i>CloudFormation Users Guide</i>.</p>
|
|
692
692
|
|
|
693
693
|
Args:
|
|
694
694
|
type_name: <p>The name of the resource type.</p>
|
|
695
695
|
type_version_id: <p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>
|
|
696
|
-
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href
|
|
697
|
-
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href
|
|
698
|
-
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href
|
|
699
|
-
patch_document: <p>A JavaScript Object Notation (JSON) document listing the patch operations that represent the updates to apply to the current resource properties. For details, see <a href
|
|
696
|
+
role_arn: <p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
697
|
+
client_token: <p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
698
|
+
identifier: <p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
699
|
+
patch_document: <p>A JavaScript Object Notation (JSON) document listing the patch operations that represent the updates to apply to the current resource properties. For details, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-update.html#resource-operations-update-patch">Composing the patch document</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>
|
|
700
700
|
|
|
701
701
|
Raises:
|
|
702
702
|
capo_cloudcontrol.errors.already_exists_exception.AlreadyExistsException: <p>The resource with the name requested already exists.</p>
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
"""Generated from Smithy shape ``com.amazonaws.cloudcontrol#CreateResourceInput``."""
|
|
2
|
+
|
|
3
|
+
from typing import TYPE_CHECKING
|
|
4
|
+
|
|
5
|
+
from typing_extensions import NotRequired, TypedDict
|
|
6
|
+
|
|
7
|
+
from capo_cloudcontrol.errors import DeserializationError
|
|
8
|
+
|
|
9
|
+
if TYPE_CHECKING:
|
|
10
|
+
import capo_cloudcontrol.types.client_token
|
|
11
|
+
import capo_cloudcontrol.types.properties
|
|
12
|
+
import capo_cloudcontrol.types.role_arn
|
|
13
|
+
import capo_cloudcontrol.types.type_name
|
|
14
|
+
import capo_cloudcontrol.types.type_version_id
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class CreateResourceInput(TypedDict, closed=True):
|
|
18
|
+
type_name: "capo_cloudcontrol.types.type_name.TypeName"
|
|
19
|
+
"""<p>The name of the resource type.</p>"""
|
|
20
|
+
type_version_id: NotRequired[
|
|
21
|
+
"capo_cloudcontrol.types.type_version_id.TypeVersionId"
|
|
22
|
+
]
|
|
23
|
+
"""<p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>"""
|
|
24
|
+
role_arn: NotRequired["capo_cloudcontrol.types.role_arn.RoleArn"]
|
|
25
|
+
"""<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>"""
|
|
26
|
+
client_token: NotRequired["capo_cloudcontrol.types.client_token.ClientToken"]
|
|
27
|
+
"""<p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>"""
|
|
28
|
+
desired_state: "capo_cloudcontrol.types.properties.Properties"
|
|
29
|
+
"""<p>Structured data format representing the desired state of the resource, consisting of that resource's properties and their desired values.</p> <note> <p>Cloud Control API currently supports JSON as a structured data format.</p> </note> <p>Specify the desired state as one of the following:</p> <ul> <li> <p>A JSON blob</p> </li> <li> <p>A local path containing the desired state in JSON data format</p> </li> </ul> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html#resource-operations-create-desiredstate">Composing the desired state of the resource</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p> <p>For more information about the properties of a specific resource, refer to the related topic for the resource in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html">Resource and property types reference</a> in the <i>CloudFormation Users Guide</i>.</p>"""
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
# --- awsJson1_0 ser/de ---
|
|
33
|
+
def serialize_aws_json_1_0(value: CreateResourceInput) -> dict:
|
|
34
|
+
out: dict = {}
|
|
35
|
+
out["TypeName"] = value["type_name"]
|
|
36
|
+
if "type_version_id" in value:
|
|
37
|
+
out["TypeVersionId"] = value["type_version_id"]
|
|
38
|
+
if "role_arn" in value:
|
|
39
|
+
out["RoleArn"] = value["role_arn"]
|
|
40
|
+
if "client_token" in value:
|
|
41
|
+
out["ClientToken"] = value["client_token"]
|
|
42
|
+
out["DesiredState"] = value["desired_state"]
|
|
43
|
+
return out
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
def deserialize_aws_json_1_0(data: dict) -> CreateResourceInput:
|
|
47
|
+
out: CreateResourceInput = {} # type: ignore[typeddict-item]
|
|
48
|
+
if data.get("TypeName") is not None:
|
|
49
|
+
out["type_name"] = data["TypeName"]
|
|
50
|
+
else:
|
|
51
|
+
raise DeserializationError("CreateResourceInput.type_name required")
|
|
52
|
+
if data.get("TypeVersionId") is not None:
|
|
53
|
+
out["type_version_id"] = data["TypeVersionId"]
|
|
54
|
+
if data.get("RoleArn") is not None:
|
|
55
|
+
out["role_arn"] = data["RoleArn"]
|
|
56
|
+
if data.get("ClientToken") is not None:
|
|
57
|
+
out["client_token"] = data["ClientToken"]
|
|
58
|
+
if data.get("DesiredState") is not None:
|
|
59
|
+
out["desired_state"] = data["DesiredState"]
|
|
60
|
+
else:
|
|
61
|
+
raise DeserializationError("CreateResourceInput.desired_state required")
|
|
62
|
+
return out
|
|
@@ -10,7 +10,7 @@ if TYPE_CHECKING:
|
|
|
10
10
|
|
|
11
11
|
class CreateResourceOutput(TypedDict, closed=True):
|
|
12
12
|
progress_event: NotRequired["capo_cloudcontrol.types.progress_event.ProgressEvent"]
|
|
13
|
-
|
|
13
|
+
"""<p>Represents the current status of the resource creation request.</p> <p>After you have initiated a resource creation request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> returned by <code>CreateResource</code>.</p>"""
|
|
14
14
|
|
|
15
15
|
|
|
16
16
|
# --- awsJson1_0 ser/de ---
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
"""Generated from Smithy shape ``com.amazonaws.cloudcontrol#DeleteResourceInput``."""
|
|
2
|
+
|
|
3
|
+
from typing import TYPE_CHECKING
|
|
4
|
+
|
|
5
|
+
from typing_extensions import NotRequired, TypedDict
|
|
6
|
+
|
|
7
|
+
from capo_cloudcontrol.errors import DeserializationError
|
|
8
|
+
|
|
9
|
+
if TYPE_CHECKING:
|
|
10
|
+
import capo_cloudcontrol.types.client_token
|
|
11
|
+
import capo_cloudcontrol.types.identifier
|
|
12
|
+
import capo_cloudcontrol.types.role_arn
|
|
13
|
+
import capo_cloudcontrol.types.type_name
|
|
14
|
+
import capo_cloudcontrol.types.type_version_id
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class DeleteResourceInput(TypedDict, closed=True):
|
|
18
|
+
type_name: "capo_cloudcontrol.types.type_name.TypeName"
|
|
19
|
+
"""<p>The name of the resource type.</p>"""
|
|
20
|
+
type_version_id: NotRequired[
|
|
21
|
+
"capo_cloudcontrol.types.type_version_id.TypeVersionId"
|
|
22
|
+
]
|
|
23
|
+
"""<p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>"""
|
|
24
|
+
role_arn: NotRequired["capo_cloudcontrol.types.role_arn.RoleArn"]
|
|
25
|
+
"""<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>"""
|
|
26
|
+
client_token: NotRequired["capo_cloudcontrol.types.client_token.ClientToken"]
|
|
27
|
+
"""<p>A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.</p> <p>A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.</p> <p>If you do not specify a client token, one is generated for inclusion in the request.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring resource operation requests are unique</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>"""
|
|
28
|
+
identifier: "capo_cloudcontrol.types.identifier.Identifier"
|
|
29
|
+
"""<p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>"""
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
# --- awsJson1_0 ser/de ---
|
|
33
|
+
def serialize_aws_json_1_0(value: DeleteResourceInput) -> dict:
|
|
34
|
+
out: dict = {}
|
|
35
|
+
out["TypeName"] = value["type_name"]
|
|
36
|
+
if "type_version_id" in value:
|
|
37
|
+
out["TypeVersionId"] = value["type_version_id"]
|
|
38
|
+
if "role_arn" in value:
|
|
39
|
+
out["RoleArn"] = value["role_arn"]
|
|
40
|
+
if "client_token" in value:
|
|
41
|
+
out["ClientToken"] = value["client_token"]
|
|
42
|
+
out["Identifier"] = value["identifier"]
|
|
43
|
+
return out
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
def deserialize_aws_json_1_0(data: dict) -> DeleteResourceInput:
|
|
47
|
+
out: DeleteResourceInput = {} # type: ignore[typeddict-item]
|
|
48
|
+
if data.get("TypeName") is not None:
|
|
49
|
+
out["type_name"] = data["TypeName"]
|
|
50
|
+
else:
|
|
51
|
+
raise DeserializationError("DeleteResourceInput.type_name required")
|
|
52
|
+
if data.get("TypeVersionId") is not None:
|
|
53
|
+
out["type_version_id"] = data["TypeVersionId"]
|
|
54
|
+
if data.get("RoleArn") is not None:
|
|
55
|
+
out["role_arn"] = data["RoleArn"]
|
|
56
|
+
if data.get("ClientToken") is not None:
|
|
57
|
+
out["client_token"] = data["ClientToken"]
|
|
58
|
+
if data.get("Identifier") is not None:
|
|
59
|
+
out["identifier"] = data["Identifier"]
|
|
60
|
+
else:
|
|
61
|
+
raise DeserializationError("DeleteResourceInput.identifier required")
|
|
62
|
+
return out
|
|
@@ -10,7 +10,7 @@ if TYPE_CHECKING:
|
|
|
10
10
|
|
|
11
11
|
class DeleteResourceOutput(TypedDict, closed=True):
|
|
12
12
|
progress_event: NotRequired["capo_cloudcontrol.types.progress_event.ProgressEvent"]
|
|
13
|
-
|
|
13
|
+
"""<p>Represents the current status of the resource deletion request.</p> <p>After you have initiated a resource deletion request, you can monitor the progress of your request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code>RequestToken</code> of the <code>ProgressEvent</code> returned by <code>DeleteResource</code>.</p>"""
|
|
14
14
|
|
|
15
15
|
|
|
16
16
|
# --- awsJson1_0 ser/de ---
|
|
@@ -21,9 +21,9 @@ class GetResourceInput(TypedDict, closed=True):
|
|
|
21
21
|
]
|
|
22
22
|
"""<p>For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.</p>"""
|
|
23
23
|
role_arn: NotRequired["capo_cloudcontrol.types.role_arn.RoleArn"]
|
|
24
|
-
|
|
24
|
+
"""<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the <code> <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a> </code> section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type definition schema</a>.</p> <p>If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying credentials</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>"""
|
|
25
25
|
identifier: "capo_cloudcontrol.types.identifier.Identifier"
|
|
26
|
-
|
|
26
|
+
"""<p>The identifier for the resource.</p> <p>You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.</p> <p>For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values <i>in the order they are specified</i> in the primary identifier definition, separated by <code>|</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-identifier.html">Identifying resources</a> in the <i>Amazon Web Services Cloud Control API User Guide</i>.</p>"""
|
|
27
27
|
|
|
28
28
|
|
|
29
29
|
# --- awsJson1_0 ser/de ---
|