create_application ¶

create_application(
    name: Name,
    client_token: ClientToken,
    *,
    config_overrides: Optional[ServiceCatalogAppRegistryClientConfig] = None,
    description: Optional[Description] = None,
    tags: Optional[Tags] = None,
) -> CreateApplicationResponse

Creates a new application that is the top-level node in a hierarchy of related cloud resource abstractions.

Parameters:

name (Name) –

The name of the application. The name must be unique in the region in which you are creating the application.
description (Optional[Description], default: None ) –

The description of the application.
tags (Optional[Tags], default: None ) –

Key-value pairs you can use to associate with the application.
client_token (ClientToken) –

A unique identifier that you provide to ensure idempotency. If you retry a request that completed successfully using the same client token and the same parameters, the retry succeeds without performing any further actions. If you retry a successful request using the same client token, but one or more of the parameters are different, the retry fails.

Raises:

ConflictException –

There was a conflict when processing the request (for example, a resource with the given name already exists within the account).
InternalServerException –

The service is experiencing internal problems.
ServiceQuotaExceededException –

The maximum number of resources per account has been reached.
ThrottlingException –

The maximum number of API requests has been exceeded.
ValidationException –

The request has invalid or missing parameters.
UnknownServiceError –

The service returned an error code this client does not model.

Source code in docs_src/capo_service_catalog_appregistry/_services/service_catalog_app_registry.py

def create_application(
    self,
    name: "capo_service_catalog_appregistry.types.name.Name",
    client_token: "capo_service_catalog_appregistry.types.client_token.ClientToken",
    *,
    config_overrides: Optional[ServiceCatalogAppRegistryClientConfig] = None,
    description: Optional[
        "capo_service_catalog_appregistry.types.description.Description"
    ] = None,
    tags: Optional["capo_service_catalog_appregistry.types.tags.Tags"] = None,
) -> "capo_service_catalog_appregistry.types.create_application_response.CreateApplicationResponse":
    """<p>Creates a new application that is the top-level node in a hierarchy of related cloud resource abstractions.</p>

    Args:
        name: <p>The name of the application. The name must be unique in the region in which you are creating the application.</p>
        description: <p>The description of the application.</p>
        tags: <p>Key-value pairs you can use to associate with the application.</p>
        client_token: <p>A unique identifier that you provide to ensure idempotency. If you retry a request that completed successfully using the same client token and the same parameters, the retry succeeds without performing any further actions. If you retry a successful request using the same client token, but one or more of the parameters are different, the retry fails.</p>

    Raises:
        capo_service_catalog_appregistry.errors.conflict_exception.ConflictException: <p>There was a conflict when processing the request (for example, a resource with the given name already exists within the account).</p>
        capo_service_catalog_appregistry.errors.internal_server_exception.InternalServerException: <p>The service is experiencing internal problems.</p>
        capo_service_catalog_appregistry.errors.service_quota_exceeded_exception.ServiceQuotaExceededException: <p> The maximum number of resources per account has been reached.</p>
        capo_service_catalog_appregistry.errors.throttling_exception.ThrottlingException: <p> The maximum number of API requests has been exceeded. </p>
        capo_service_catalog_appregistry.errors.validation_exception.ValidationException: <p>The request has invalid or missing parameters.</p>
        capo_service_catalog_appregistry.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_service_catalog_appregistry.types.create_application_request.CreateApplicationRequest]",
    ) -> OperationResponse[
        "capo_service_catalog_appregistry.types.create_application_response.CreateApplicationResponse"
    ]:
        import capo_service_catalog_appregistry._operations.aws242_app_registry.create_application

        output, http_response = (
            capo_service_catalog_appregistry._operations.aws242_app_registry.create_application.create_application(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateApplication")
    )
    input_: capo_service_catalog_appregistry.types.create_application_request.CreateApplicationRequest = {
        "name": name,
        "client_token": client_token,
    }
    if description is not None:
        input_["description"] = description
    if tags is not None:
        input_["tags"] = tags

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output