{ "version": "2.0", "metadata": { "apiVersion": "2020-06-24", "endpointPrefix": "servicecatalog-appregistry", "jsonVersion": "1.1", "protocol": "rest-json", "serviceAbbreviation": "AppRegistry", "serviceFullName": "AWS Service Catalog App Registry", "serviceId": "Service Catalog AppRegistry", "signatureVersion": "v4", "signingName": "servicecatalog", "uid": "AWS242AppRegistry-2020-06-24" }, "operations": { "AssociateAttributeGroup": { "name": "AssociateAttributeGroup", "http": { "method": "PUT", "requestUri": "/applications/{application}/attribute-groups/{attributeGroup}" }, "input": { "shape": "AssociateAttributeGroupRequest" }, "output": { "shape": "AssociateAttributeGroupResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" }, { "shape": "ServiceQuotaExceededException" }, { "shape": "ConflictException" } ], "documentation": "

Associates an attribute group with an application to augment the application's metadata with the group's attributes. This feature enables applications to be described with user-defined details that are machine-readable, such as third-party integrations.

" }, "AssociateResource": { "name": "AssociateResource", "http": { "method": "PUT", "requestUri": "/applications/{application}/resources/{resourceType}/{resource}" }, "input": { "shape": "AssociateResourceRequest" }, "output": { "shape": "AssociateResourceResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" }, { "shape": "ServiceQuotaExceededException" }, { "shape": "ConflictException" }, { "shape": "ValidationException" }, { "shape": "ThrottlingException" } ], "documentation": "

Associates a resource with an application. The resource can be specified by its ARN or name. The application can be specified by ARN, ID, or name.

Minimum permissions

You must have the following permissions to associate a resource using the OPTIONS parameter set to APPLY_APPLICATION_TAG.

You must also have these additional permissions if you don't use the AWSServiceCatalogAppRegistryFullAccess policy. For more information, see AWSServiceCatalogAppRegistryFullAccess in the AppRegistry Administrator Guide.

In addition, you must have the tagging permission defined by the Amazon Web Services service that creates the resource. For more information, see TagResources in the Resource Groups Tagging API Reference.

" }, "CreateApplication": { "name": "CreateApplication", "http": { "method": "POST", "requestUri": "/applications", "responseCode": 201 }, "input": { "shape": "CreateApplicationRequest" }, "output": { "shape": "CreateApplicationResponse" }, "errors": [ { "shape": "ServiceQuotaExceededException" }, { "shape": "ConflictException" }, { "shape": "InternalServerException" }, { "shape": "ValidationException" }, { "shape": "ThrottlingException" } ], "documentation": "

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

" }, "CreateAttributeGroup": { "name": "CreateAttributeGroup", "http": { "method": "POST", "requestUri": "/attribute-groups", "responseCode": 201 }, "input": { "shape": "CreateAttributeGroupRequest" }, "output": { "shape": "CreateAttributeGroupResponse" }, "errors": [ { "shape": "ServiceQuotaExceededException" }, { "shape": "ConflictException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Creates a new attribute group as a container for user-defined attributes. This feature enables users to have full control over their cloud application's metadata in a rich machine-readable format to facilitate integration with automated workflows and third-party tools.

" }, "DeleteApplication": { "name": "DeleteApplication", "http": { "method": "DELETE", "requestUri": "/applications/{application}" }, "input": { "shape": "DeleteApplicationRequest" }, "output": { "shape": "DeleteApplicationResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Deletes an application that is specified either by its application ID, name, or ARN. All associated attribute groups and resources must be disassociated from it before deleting an application.

" }, "DeleteAttributeGroup": { "name": "DeleteAttributeGroup", "http": { "method": "DELETE", "requestUri": "/attribute-groups/{attributeGroup}" }, "input": { "shape": "DeleteAttributeGroupRequest" }, "output": { "shape": "DeleteAttributeGroupResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Deletes an attribute group, specified either by its attribute group ID, name, or ARN.

" }, "DisassociateAttributeGroup": { "name": "DisassociateAttributeGroup", "http": { "method": "DELETE", "requestUri": "/applications/{application}/attribute-groups/{attributeGroup}" }, "input": { "shape": "DisassociateAttributeGroupRequest" }, "output": { "shape": "DisassociateAttributeGroupResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Disassociates an attribute group from an application to remove the extra attributes contained in the attribute group from the application's metadata. This operation reverts AssociateAttributeGroup.

" }, "DisassociateResource": { "name": "DisassociateResource", "http": { "method": "DELETE", "requestUri": "/applications/{application}/resources/{resourceType}/{resource}" }, "input": { "shape": "DisassociateResourceRequest" }, "output": { "shape": "DisassociateResourceResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" }, { "shape": "ValidationException" }, { "shape": "ThrottlingException" } ], "documentation": "

Disassociates a resource from application. Both the resource and the application can be specified either by ID or name.

Minimum permissions

You must have the following permissions to remove a resource that's been associated with an application using the APPLY_APPLICATION_TAG option for AssociateResource.

You must also have the following permissions if you don't use the AWSServiceCatalogAppRegistryFullAccess policy. For more information, see AWSServiceCatalogAppRegistryFullAccess in the AppRegistry Administrator Guide.

In addition, you must have the tagging permission defined by the Amazon Web Services service that creates the resource. For more information, see UntagResources in the Resource Groups Tagging API Reference.

" }, "GetApplication": { "name": "GetApplication", "http": { "method": "GET", "requestUri": "/applications/{application}" }, "input": { "shape": "GetApplicationRequest" }, "output": { "shape": "GetApplicationResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" }, { "shape": "ConflictException" } ], "documentation": "

Retrieves metadata information about one of your applications. The application can be specified by its ARN, ID, or name (which is unique within one account in one region at a given point in time). Specify by ARN or ID in automated workflows if you want to make sure that the exact same application is returned or a ResourceNotFoundException is thrown, avoiding the ABA addressing problem.

" }, "GetAssociatedResource": { "name": "GetAssociatedResource", "http": { "method": "GET", "requestUri": "/applications/{application}/resources/{resourceType}/{resource}" }, "input": { "shape": "GetAssociatedResourceRequest" }, "output": { "shape": "GetAssociatedResourceResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Gets the resource associated with the application.

", "idempotent": true }, "GetAttributeGroup": { "name": "GetAttributeGroup", "http": { "method": "GET", "requestUri": "/attribute-groups/{attributeGroup}" }, "input": { "shape": "GetAttributeGroupRequest" }, "output": { "shape": "GetAttributeGroupResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" }, { "shape": "ConflictException" } ], "documentation": "

Retrieves an attribute group by its ARN, ID, or name. The attribute group can be specified by its ARN, ID, or name.

" }, "GetConfiguration": { "name": "GetConfiguration", "http": { "method": "GET", "requestUri": "/configuration" }, "output": { "shape": "GetConfigurationResponse" }, "errors": [ { "shape": "InternalServerException" } ], "documentation": "

Retrieves a TagKey configuration from an account.

" }, "ListApplications": { "name": "ListApplications", "http": { "method": "GET", "requestUri": "/applications" }, "input": { "shape": "ListApplicationsRequest" }, "output": { "shape": "ListApplicationsResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Retrieves a list of all of your applications. Results are paginated.

", "idempotent": true }, "ListAssociatedAttributeGroups": { "name": "ListAssociatedAttributeGroups", "http": { "method": "GET", "requestUri": "/applications/{application}/attribute-groups" }, "input": { "shape": "ListAssociatedAttributeGroupsRequest" }, "output": { "shape": "ListAssociatedAttributeGroupsResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Lists all attribute groups that are associated with specified application. Results are paginated.

", "idempotent": true }, "ListAssociatedResources": { "name": "ListAssociatedResources", "http": { "method": "GET", "requestUri": "/applications/{application}/resources" }, "input": { "shape": "ListAssociatedResourcesRequest" }, "output": { "shape": "ListAssociatedResourcesResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Lists all of the resources that are associated with the specified application. Results are paginated.

If you share an application, and a consumer account associates a tag query to the application, all of the users who can access the application can also view the tag values in all accounts that are associated with it using this API.

", "idempotent": true }, "ListAttributeGroups": { "name": "ListAttributeGroups", "http": { "method": "GET", "requestUri": "/attribute-groups" }, "input": { "shape": "ListAttributeGroupsRequest" }, "output": { "shape": "ListAttributeGroupsResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Lists all attribute groups which you have access to. Results are paginated.

", "idempotent": true }, "ListAttributeGroupsForApplication": { "name": "ListAttributeGroupsForApplication", "http": { "method": "GET", "requestUri": "/applications/{application}/attribute-group-details" }, "input": { "shape": "ListAttributeGroupsForApplicationRequest" }, "output": { "shape": "ListAttributeGroupsForApplicationResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" } ], "documentation": "

Lists the details of all attribute groups associated with a specific application. The results display in pages.

", "idempotent": true }, "ListTagsForResource": { "name": "ListTagsForResource", "http": { "method": "GET", "requestUri": "/tags/{resourceArn}" }, "input": { "shape": "ListTagsForResourceRequest" }, "output": { "shape": "ListTagsForResourceResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" } ], "documentation": "

Lists all of the tags on the resource.

" }, "PutConfiguration": { "name": "PutConfiguration", "http": { "method": "PUT", "requestUri": "/configuration" }, "input": { "shape": "PutConfigurationRequest" }, "errors": [ { "shape": "ConflictException" }, { "shape": "InternalServerException" }, { "shape": "ValidationException" } ], "documentation": "

Associates a TagKey configuration to an account.

" }, "SyncResource": { "name": "SyncResource", "http": { "method": "POST", "requestUri": "/sync/{resourceType}/{resource}" }, "input": { "shape": "SyncResourceRequest" }, "output": { "shape": "SyncResourceResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" }, { "shape": "ConflictException" }, { "shape": "ThrottlingException" }, { "shape": "ValidationException" } ], "documentation": "

Syncs the resource with current AppRegistry records.

Specifically, the resource’s AppRegistry system tags sync with its associated application. We remove the resource's AppRegistry system tags if it does not associate with the application. The caller must have permissions to read and update the resource.

" }, "TagResource": { "name": "TagResource", "http": { "method": "POST", "requestUri": "/tags/{resourceArn}" }, "input": { "shape": "TagResourceRequest" }, "output": { "shape": "TagResourceResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" } ], "documentation": "

Assigns one or more tags (key-value pairs) to the specified resource.

Each tag consists of a key and an optional value. If a tag with the same key is already associated with the resource, this action updates its value.

This operation returns an empty response if the call was successful.

" }, "UntagResource": { "name": "UntagResource", "http": { "method": "DELETE", "requestUri": "/tags/{resourceArn}" }, "input": { "shape": "UntagResourceRequest" }, "output": { "shape": "UntagResourceResponse" }, "errors": [ { "shape": "ValidationException" }, { "shape": "ResourceNotFoundException" }, { "shape": "InternalServerException" } ], "documentation": "

Removes tags from a resource.

This operation returns an empty response if the call was successful.

" }, "UpdateApplication": { "name": "UpdateApplication", "http": { "method": "PATCH", "requestUri": "/applications/{application}" }, "input": { "shape": "UpdateApplicationRequest" }, "output": { "shape": "UpdateApplicationResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ConflictException" }, { "shape": "ValidationException" }, { "shape": "InternalServerException" }, { "shape": "ThrottlingException" } ], "documentation": "

Updates an existing application with new attributes.

" }, "UpdateAttributeGroup": { "name": "UpdateAttributeGroup", "http": { "method": "PATCH", "requestUri": "/attribute-groups/{attributeGroup}" }, "input": { "shape": "UpdateAttributeGroupRequest" }, "output": { "shape": "UpdateAttributeGroupResponse" }, "errors": [ { "shape": "ResourceNotFoundException" }, { "shape": "ValidationException" }, { "shape": "ConflictException" }, { "shape": "InternalServerException" } ], "documentation": "

Updates an existing attribute group with new details.

" } }, "shapes": { "AppRegistryConfiguration": { "type": "structure", "members": { "tagQueryConfiguration": { "shape": "TagQueryConfiguration", "documentation": "

Includes the definition of a tagQuery.

" } }, "documentation": "

Includes all of the AppRegistry settings.

" }, "Application": { "type": "structure", "members": { "id": { "shape": "ApplicationId", "documentation": "

The identifier of the application.

" }, "arn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) that specifies the application across services.

" }, "name": { "shape": "Name", "documentation": "

The name of the application. The name must be unique in the region in which you are creating the application.

" }, "description": { "shape": "Description", "documentation": "

The description of the application.

" }, "creationTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment when the application was created.

" }, "lastUpdateTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment when the application was last updated.

" }, "tags": { "shape": "Tags", "documentation": "

Key-value pairs you can use to associate with the application.

" }, "applicationTag": { "shape": "ApplicationTagDefinition", "documentation": "

A key-value pair that identifies an associated resource.

" } }, "documentation": "

Represents a Amazon Web Services Service Catalog AppRegistry application that is the top-level node in a hierarchy of related cloud resource abstractions.

" }, "ApplicationArn": { "type": "string", "pattern": "arn:aws[-a-z]*:servicecatalog:[a-z]{2}(-gov)?-[a-z]+-\\d:\\d{12}:/applications/[a-z0-9]+" }, "ApplicationId": { "type": "string", "max": 26, "min": 26, "pattern": "[a-z0-9]+" }, "ApplicationSpecifier": { "type": "string", "max": 256, "min": 1, "pattern": "([-.\\w]+)|(arn:aws[-a-z]*:servicecatalog:[a-z]{2}(-gov)?-[a-z]+-\\d:\\d{12}:/applications/[-.\\w]+)" }, "ApplicationSummaries": { "type": "list", "member": { "shape": "ApplicationSummary" } }, "ApplicationSummary": { "type": "structure", "members": { "id": { "shape": "ApplicationId", "documentation": "

The identifier of the application.

" }, "arn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) that specifies the application across services.

" }, "name": { "shape": "Name", "documentation": "

The name of the application. The name must be unique in the region in which you are creating the application.

" }, "description": { "shape": "Description", "documentation": "

The description of the application.

" }, "creationTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment when the application was created.

" }, "lastUpdateTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment when the application was last updated.

" } }, "documentation": "

Summary of a Amazon Web Services Service Catalog AppRegistry application.

" }, "ApplicationTagDefinition": { "type": "map", "key": { "shape": "TagKey" }, "value": { "shape": "TagValue" } }, "ApplicationTagResult": { "type": "structure", "members": { "applicationTagStatus": { "shape": "ApplicationTagStatus", "documentation": "

The application tag is in the process of being applied to a resource, was successfully applied to a resource, or failed to apply to a resource.

" }, "errorMessage": { "shape": "String", "documentation": "

The message returned if the call fails.

" }, "resources": { "shape": "ResourcesList", "documentation": "

The resources associated with an application

" }, "nextToken": { "shape": "NextToken", "documentation": "

A unique pagination token for each page of results. Make the call again with the returned token to retrieve the next page of results.

" } }, "documentation": "

The result of the application tag that's applied to a resource.

" }, "ApplicationTagStatus": { "type": "string", "enum": [ "IN_PROGRESS", "SUCCESS", "FAILURE" ] }, "Arn": { "type": "string", "max": 1600, "min": 1, "pattern": "arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\\-])+:([a-z]{2}(-gov)?-[a-z]+-\\d{1})?:(\\d{12})?:(.*)" }, "AssociateAttributeGroupRequest": { "type": "structure", "required": [ "application", "attributeGroup" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application.

", "location": "uri", "locationName": "application" }, "attributeGroup": { "shape": "AttributeGroupSpecifier", "documentation": "

The name, ID, or ARN of the attribute group that holds the attributes to describe the application.

", "location": "uri", "locationName": "attributeGroup" } } }, "AssociateAttributeGroupResponse": { "type": "structure", "members": { "applicationArn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) of the application that was augmented with attributes.

" }, "attributeGroupArn": { "shape": "AttributeGroupArn", "documentation": "

The Amazon resource name (ARN) of the attribute group that contains the application's new attributes.

" } } }, "AssociateResourceRequest": { "type": "structure", "required": [ "application", "resourceType", "resource" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application.

", "location": "uri", "locationName": "application" }, "resourceType": { "shape": "ResourceType", "documentation": "

The type of resource of which the application will be associated.

", "location": "uri", "locationName": "resourceType" }, "resource": { "shape": "ResourceSpecifier", "documentation": "

The name or ID of the resource of which the application will be associated.

", "location": "uri", "locationName": "resource" }, "options": { "shape": "Options", "documentation": "

Determines whether an application tag is applied or skipped.

" } } }, "AssociateResourceResponse": { "type": "structure", "members": { "applicationArn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) of the application that was augmented with attributes.

" }, "resourceArn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) that specifies the resource.

" }, "options": { "shape": "Options", "documentation": "

Determines whether an application tag is applied or skipped.

" } } }, "AssociationCount": { "type": "integer", "min": 0 }, "AssociationOption": { "type": "string", "enum": [ "APPLY_APPLICATION_TAG", "SKIP_APPLICATION_TAG" ] }, "AttributeGroup": { "type": "structure", "members": { "id": { "shape": "AttributeGroupId", "documentation": "

The globally unique attribute group identifier of the attribute group.

" }, "arn": { "shape": "AttributeGroupArn", "documentation": "

The Amazon resource name (ARN) that specifies the attribute group across services.

" }, "name": { "shape": "Name", "documentation": "

The name of the attribute group.

" }, "description": { "shape": "Description", "documentation": "

The description of the attribute group that the user provides.

" }, "creationTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment the attribute group was created.

" }, "lastUpdateTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment the attribute group was last updated. This time is the same as the creationTime for a newly created attribute group.

" }, "tags": { "shape": "Tags", "documentation": "

Key-value pairs you can use to associate with the attribute group.

" } }, "documentation": "

Represents a Amazon Web Services Service Catalog AppRegistry attribute group that is rich metadata which describes an application and its components.

" }, "AttributeGroupArn": { "type": "string", "pattern": "arn:aws[-a-z]*:servicecatalog:[a-z]{2}(-gov)?-[a-z]+-\\d:\\d{12}:/attribute-groups/[-.\\w]+" }, "AttributeGroupDetails": { "type": "structure", "members": { "id": { "shape": "AttributeGroupId", "documentation": "

The unique identifier of the attribute group.

" }, "arn": { "shape": "AttributeGroupArn", "documentation": "

The Amazon resource name (ARN) that specifies the attribute group.

" }, "name": { "shape": "Name", "documentation": "

This field is no longer supported. We recommend you don't use the field when using ListAttributeGroupsForApplication.

The name of the attribute group.

" }, "createdBy": { "shape": "CreatedBy", "documentation": "

The service principal that created the attribute group.

" } }, "documentation": "

The details related to a specific AttributeGroup.

" }, "AttributeGroupDetailsList": { "type": "list", "member": { "shape": "AttributeGroupDetails" } }, "AttributeGroupId": { "type": "string", "max": 256, "min": 1, "pattern": "[-.\\w]+" }, "AttributeGroupIds": { "type": "list", "member": { "shape": "AttributeGroupId" } }, "AttributeGroupSpecifier": { "type": "string", "max": 512, "min": 1, "pattern": "([-.\\w]+)|(arn:aws[-a-z]*:servicecatalog:[a-z]{2}(-gov)?-[a-z]+-\\d:\\d{12}:/attribute-groups/[-.\\w]+)" }, "AttributeGroupSummaries": { "type": "list", "member": { "shape": "AttributeGroupSummary" } }, "AttributeGroupSummary": { "type": "structure", "members": { "id": { "shape": "AttributeGroupId", "documentation": "

The globally unique attribute group identifier of the attribute group.

" }, "arn": { "shape": "AttributeGroupArn", "documentation": "

The Amazon resource name (ARN) that specifies the attribute group across services.

" }, "name": { "shape": "Name", "documentation": "

The name of the attribute group.

" }, "description": { "shape": "Description", "documentation": "

The description of the attribute group that the user provides.

" }, "creationTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment the attribute group was created.

" }, "lastUpdateTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment the attribute group was last updated. This time is the same as the creationTime for a newly created attribute group.

" }, "createdBy": { "shape": "CreatedBy", "documentation": "

The service principal that created the attribute group.

" } }, "documentation": "

Summary of a Amazon Web Services Service Catalog AppRegistry attribute group.

" }, "Attributes": { "type": "string", "max": 8000, "min": 1, "pattern": "[\\u0009\\u000A\\u000D\\u0020-\\u00FF]+" }, "ClientToken": { "type": "string", "max": 128, "min": 1, "pattern": "[a-zA-Z0-9][a-zA-Z0-9_-]*" }, "CreateApplicationRequest": { "type": "structure", "required": [ "name", "clientToken" ], "members": { "name": { "shape": "Name", "documentation": "

The name of the application. The name must be unique in the region in which you are creating the application.

" }, "description": { "shape": "Description", "documentation": "

The description of the application.

" }, "tags": { "shape": "Tags", "documentation": "

Key-value pairs you can use to associate with the application.

" }, "clientToken": { "shape": "ClientToken", "documentation": "

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.

", "idempotencyToken": true } } }, "CreateApplicationResponse": { "type": "structure", "members": { "application": { "shape": "Application", "documentation": "

Information about the application.

" } } }, "CreateAttributeGroupRequest": { "type": "structure", "required": [ "name", "attributes", "clientToken" ], "members": { "name": { "shape": "Name", "documentation": "

The name of the attribute group.

" }, "description": { "shape": "Description", "documentation": "

The description of the attribute group that the user provides.

" }, "attributes": { "shape": "Attributes", "documentation": "

A JSON string in the form of nested key-value pairs that represent the attributes in the group and describes an application and its components.

" }, "tags": { "shape": "Tags", "documentation": "

Key-value pairs you can use to associate with the attribute group.

" }, "clientToken": { "shape": "ClientToken", "documentation": "

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.

", "idempotencyToken": true } } }, "CreateAttributeGroupResponse": { "type": "structure", "members": { "attributeGroup": { "shape": "AttributeGroup", "documentation": "

Information about the attribute group.

" } } }, "CreatedBy": { "type": "string", "max": 128, "min": 1, "pattern": "^(?!-)([a-z0-9-]+\\.)+(aws\\.internal|amazonaws\\.com(\\.cn)?)$" }, "DeleteApplicationRequest": { "type": "structure", "required": [ "application" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application.

", "location": "uri", "locationName": "application" } } }, "DeleteApplicationResponse": { "type": "structure", "members": { "application": { "shape": "ApplicationSummary", "documentation": "

Information about the deleted application.

" } } }, "DeleteAttributeGroupRequest": { "type": "structure", "required": [ "attributeGroup" ], "members": { "attributeGroup": { "shape": "AttributeGroupSpecifier", "documentation": "

The name, ID, or ARN of the attribute group that holds the attributes to describe the application.

", "location": "uri", "locationName": "attributeGroup" } } }, "DeleteAttributeGroupResponse": { "type": "structure", "members": { "attributeGroup": { "shape": "AttributeGroupSummary", "documentation": "

Information about the deleted attribute group.

" } } }, "Description": { "type": "string", "max": 1024 }, "DisassociateAttributeGroupRequest": { "type": "structure", "required": [ "application", "attributeGroup" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application.

", "location": "uri", "locationName": "application" }, "attributeGroup": { "shape": "AttributeGroupSpecifier", "documentation": "

The name, ID, or ARN of the attribute group that holds the attributes to describe the application.

", "location": "uri", "locationName": "attributeGroup" } } }, "DisassociateAttributeGroupResponse": { "type": "structure", "members": { "applicationArn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) that specifies the application.

" }, "attributeGroupArn": { "shape": "AttributeGroupArn", "documentation": "

The Amazon resource name (ARN) that specifies the attribute group.

" } } }, "DisassociateResourceRequest": { "type": "structure", "required": [ "application", "resourceType", "resource" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name or ID of the application.

", "location": "uri", "locationName": "application" }, "resourceType": { "shape": "ResourceType", "documentation": "

The type of the resource that is being disassociated.

", "location": "uri", "locationName": "resourceType" }, "resource": { "shape": "ResourceSpecifier", "documentation": "

The name or ID of the resource.

", "location": "uri", "locationName": "resource" } } }, "DisassociateResourceResponse": { "type": "structure", "members": { "applicationArn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) that specifies the application.

" }, "resourceArn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) that specifies the resource.

" } } }, "GetApplicationRequest": { "type": "structure", "required": [ "application" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application.

", "location": "uri", "locationName": "application" } } }, "GetApplicationResponse": { "type": "structure", "members": { "id": { "shape": "ApplicationId", "documentation": "

The identifier of the application.

" }, "arn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) that specifies the application across services.

" }, "name": { "shape": "Name", "documentation": "

The name of the application. The name must be unique in the region in which you are creating the application.

" }, "description": { "shape": "Description", "documentation": "

The description of the application.

" }, "creationTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment when the application was created.

" }, "lastUpdateTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment when the application was last updated.

" }, "associatedResourceCount": { "shape": "AssociationCount", "documentation": "

The number of top-level resources that were registered as part of this application.

" }, "tags": { "shape": "Tags", "documentation": "

Key-value pairs associated with the application.

" }, "integrations": { "shape": "Integrations", "documentation": "

The information about the integration of the application with other services, such as Resource Groups.

" }, "applicationTag": { "shape": "ApplicationTagDefinition", "documentation": "

A key-value pair that identifies an associated resource.

" } } }, "GetAssociatedResourceFilter": { "type": "list", "member": { "shape": "ResourceItemStatus" }, "max": 4, "min": 1 }, "GetAssociatedResourceRequest": { "type": "structure", "required": [ "application", "resourceType", "resource" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application.

", "location": "uri", "locationName": "application" }, "resourceType": { "shape": "ResourceType", "documentation": "

The type of resource associated with the application.

", "location": "uri", "locationName": "resourceType" }, "resource": { "shape": "ResourceSpecifier", "documentation": "

The name or ID of the resource associated with the application.

", "location": "uri", "locationName": "resource" }, "nextToken": { "shape": "NextToken", "documentation": "

A unique pagination token for each page of results. Make the call again with the returned token to retrieve the next page of results.

", "location": "querystring", "locationName": "nextToken" }, "resourceTagStatus": { "shape": "GetAssociatedResourceFilter", "documentation": "

States whether an application tag is applied, not applied, in the process of being applied, or skipped.

", "location": "querystring", "locationName": "resourceTagStatus" }, "maxResults": { "shape": "MaxResults", "documentation": "

The maximum number of results to return. If the parameter is omitted, it defaults to 25. The value is optional.

", "box": true, "location": "querystring", "locationName": "maxResults" } } }, "GetAssociatedResourceResponse": { "type": "structure", "members": { "resource": { "shape": "Resource", "documentation": "

The resource associated with the application.

" }, "options": { "shape": "Options", "documentation": "

Determines whether an application tag is applied or skipped.

" }, "applicationTagResult": { "shape": "ApplicationTagResult", "documentation": "

The result of the application that's tag applied to a resource.

" } } }, "GetAttributeGroupRequest": { "type": "structure", "required": [ "attributeGroup" ], "members": { "attributeGroup": { "shape": "AttributeGroupSpecifier", "documentation": "

The name, ID, or ARN of the attribute group that holds the attributes to describe the application.

", "location": "uri", "locationName": "attributeGroup" } } }, "GetAttributeGroupResponse": { "type": "structure", "members": { "id": { "shape": "AttributeGroupId", "documentation": "

The identifier of the attribute group.

" }, "arn": { "shape": "AttributeGroupArn", "documentation": "

The Amazon resource name (ARN) that specifies the attribute group across services.

" }, "name": { "shape": "Name", "documentation": "

The name of the attribute group.

" }, "description": { "shape": "Description", "documentation": "

The description of the attribute group that the user provides.

" }, "attributes": { "shape": "Attributes", "documentation": "

A JSON string in the form of nested key-value pairs that represent the attributes in the group and describes an application and its components.

" }, "creationTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment the attribute group was created.

" }, "lastUpdateTime": { "shape": "Timestamp", "documentation": "

The ISO-8601 formatted timestamp of the moment the attribute group was last updated. This time is the same as the creationTime for a newly created attribute group.

" }, "tags": { "shape": "Tags", "documentation": "

Key-value pairs associated with the attribute group.

" }, "createdBy": { "shape": "CreatedBy", "documentation": "

The service principal that created the attribute group.

" } } }, "GetConfigurationResponse": { "type": "structure", "members": { "configuration": { "shape": "AppRegistryConfiguration", "documentation": "

Retrieves TagKey configuration from an account.

" } } }, "Integrations": { "type": "structure", "members": { "resourceGroup": { "shape": "ResourceGroup", "documentation": "

The information about the resource group integration.

" }, "applicationTagResourceGroup": { "shape": "ResourceGroup" } }, "documentation": "

The information about the service integration.

" }, "ListApplicationsRequest": { "type": "structure", "members": { "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

", "location": "querystring", "locationName": "nextToken" }, "maxResults": { "shape": "MaxResults", "documentation": "

The upper bound of the number of results to return (cannot exceed 25). If this parameter is omitted, it defaults to 25. This value is optional.

", "box": true, "location": "querystring", "locationName": "maxResults" } } }, "ListApplicationsResponse": { "type": "structure", "members": { "applications": { "shape": "ApplicationSummaries", "documentation": "

This list of applications.

" }, "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

" } } }, "ListAssociatedAttributeGroupsRequest": { "type": "structure", "required": [ "application" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name or ID of the application.

", "location": "uri", "locationName": "application" }, "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

", "location": "querystring", "locationName": "nextToken" }, "maxResults": { "shape": "MaxResults", "documentation": "

The upper bound of the number of results to return (cannot exceed 25). If this parameter is omitted, it defaults to 25. This value is optional.

", "box": true, "location": "querystring", "locationName": "maxResults" } } }, "ListAssociatedAttributeGroupsResponse": { "type": "structure", "members": { "attributeGroups": { "shape": "AttributeGroupIds", "documentation": "

A list of attribute group IDs.

" }, "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

" } } }, "ListAssociatedResourcesRequest": { "type": "structure", "required": [ "application" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application.

", "location": "uri", "locationName": "application" }, "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

", "location": "querystring", "locationName": "nextToken" }, "maxResults": { "shape": "MaxResults", "documentation": "

The upper bound of the number of results to return (cannot exceed 25). If this parameter is omitted, it defaults to 25. This value is optional.

", "box": true, "location": "querystring", "locationName": "maxResults" } } }, "ListAssociatedResourcesResponse": { "type": "structure", "members": { "resources": { "shape": "Resources", "documentation": "

Information about the resources.

" }, "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

" } } }, "ListAttributeGroupsForApplicationRequest": { "type": "structure", "required": [ "application" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name or ID of the application.

", "location": "uri", "locationName": "application" }, "nextToken": { "shape": "NextToken", "documentation": "

This token retrieves the next page of results after a previous API call.

", "location": "querystring", "locationName": "nextToken" }, "maxResults": { "shape": "MaxResults", "documentation": "

The upper bound of the number of results to return. The value cannot exceed 25. If you omit this parameter, it defaults to 25. This value is optional.

", "box": true, "location": "querystring", "locationName": "maxResults" } } }, "ListAttributeGroupsForApplicationResponse": { "type": "structure", "members": { "attributeGroupsDetails": { "shape": "AttributeGroupDetailsList", "documentation": "

The details related to a specific attribute group.

" }, "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

" } } }, "ListAttributeGroupsRequest": { "type": "structure", "members": { "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

", "location": "querystring", "locationName": "nextToken" }, "maxResults": { "shape": "MaxResults", "documentation": "

The upper bound of the number of results to return (cannot exceed 25). If this parameter is omitted, it defaults to 25. This value is optional.

", "box": true, "location": "querystring", "locationName": "maxResults" } } }, "ListAttributeGroupsResponse": { "type": "structure", "members": { "attributeGroups": { "shape": "AttributeGroupSummaries", "documentation": "

This list of attribute groups.

" }, "nextToken": { "shape": "NextToken", "documentation": "

The token to use to get the next page of results after a previous API call.

" } } }, "ListTagsForResourceRequest": { "type": "structure", "required": [ "resourceArn" ], "members": { "resourceArn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) that specifies the resource.

", "location": "uri", "locationName": "resourceArn" } } }, "ListTagsForResourceResponse": { "type": "structure", "members": { "tags": { "shape": "Tags", "documentation": "

The tags on the resource.

" } } }, "MaxResults": { "type": "integer", "max": 100, "min": 1 }, "Name": { "type": "string", "max": 256, "min": 1, "pattern": "[-.\\w]+" }, "NextToken": { "type": "string", "max": 2024, "min": 1, "pattern": "[A-Za-z0-9+/=]+" }, "Options": { "type": "list", "member": { "shape": "AssociationOption" } }, "PutConfigurationRequest": { "type": "structure", "required": [ "configuration" ], "members": { "configuration": { "shape": "AppRegistryConfiguration", "documentation": "

Associates a TagKey configuration to an account.

" } } }, "Resource": { "type": "structure", "members": { "name": { "shape": "ResourceSpecifier", "documentation": "

The name of the resource.

" }, "arn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) of the resource.

" }, "associationTime": { "shape": "Timestamp", "documentation": "

The time the resource was associated with the application.

" }, "integrations": { "shape": "ResourceIntegrations", "documentation": "

The service integration information about the resource.

" } }, "documentation": "

The information about the resource.

" }, "ResourceDetails": { "type": "structure", "members": { "tagValue": { "shape": "TagValue", "documentation": "

The value of the tag.

" } }, "documentation": "

The details related to the resource.

" }, "ResourceGroup": { "type": "structure", "members": { "state": { "shape": "ResourceGroupState", "documentation": "

The state of the propagation process for the resource group. The states includes:

CREATING if the resource group is in the process of being created.

CREATE_COMPLETE if the resource group was created successfully.

CREATE_FAILED if the resource group failed to be created.

UPDATING if the resource group is in the process of being updated.

UPDATE_COMPLETE if the resource group updated successfully.

UPDATE_FAILED if the resource group could not update successfully.

" }, "arn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) of the resource group.

" }, "errorMessage": { "shape": "String", "documentation": "

The error message that generates when the propagation process for the resource group fails.

" } }, "documentation": "

The information about the resource group integration.

" }, "ResourceGroupState": { "type": "string", "enum": [ "CREATING", "CREATE_COMPLETE", "CREATE_FAILED", "UPDATING", "UPDATE_COMPLETE", "UPDATE_FAILED" ] }, "ResourceInfo": { "type": "structure", "members": { "name": { "shape": "ResourceSpecifier", "documentation": "

The name of the resource.

" }, "arn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) that specifies the resource across services.

" }, "resourceType": { "shape": "ResourceType", "documentation": "

Provides information about the Service Catalog App Registry resource type.

" }, "resourceDetails": { "shape": "ResourceDetails", "documentation": "

The details related to the resource.

" }, "options": { "shape": "Options", "documentation": "

Determines whether an application tag is applied or skipped.

" } }, "documentation": "

The information about the resource.

" }, "ResourceIntegrations": { "type": "structure", "members": { "resourceGroup": { "shape": "ResourceGroup", "documentation": "

The information about the integration of Resource Groups.

" } }, "documentation": "

The service integration information about the resource.

" }, "ResourceItemStatus": { "type": "string", "enum": [ "SUCCESS", "FAILED", "IN_PROGRESS", "SKIPPED" ] }, "ResourceItemType": { "type": "string", "pattern": "AWS::[a-zA-Z0-9]+::\\w+" }, "ResourceSpecifier": { "type": "string", "max": 256, "min": 1, "pattern": "\\S+" }, "ResourceType": { "type": "string", "enum": [ "CFN_STACK", "RESOURCE_TAG_VALUE" ] }, "Resources": { "type": "list", "member": { "shape": "ResourceInfo" } }, "ResourcesList": { "type": "list", "member": { "shape": "ResourcesListItem" } }, "ResourcesListItem": { "type": "structure", "members": { "resourceArn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) of the resource.

" }, "errorMessage": { "shape": "ResourcesListItemErrorMessage", "documentation": "

The message returned if the call fails.

" }, "status": { "shape": "String", "documentation": "

The status of the list item.

" }, "resourceType": { "shape": "ResourceItemType", "documentation": "

Provides information about the AppRegistry resource type.

" } }, "documentation": "

The resource in a list of resources.

" }, "ResourcesListItemErrorMessage": { "type": "string", "max": 1024, "min": 1 }, "String": { "type": "string" }, "SyncAction": { "type": "string", "enum": [ "START_SYNC", "NO_ACTION" ] }, "SyncResourceRequest": { "type": "structure", "required": [ "resourceType", "resource" ], "members": { "resourceType": { "shape": "ResourceType", "documentation": "

The type of resource of which the application will be associated.

", "location": "uri", "locationName": "resourceType" }, "resource": { "shape": "ResourceSpecifier", "documentation": "

An entity you can work with and specify with a name or ID. Examples include an Amazon EC2 instance, an Amazon Web Services CloudFormation stack, or an Amazon S3 bucket.

", "location": "uri", "locationName": "resource" } } }, "SyncResourceResponse": { "type": "structure", "members": { "applicationArn": { "shape": "ApplicationArn", "documentation": "

The Amazon resource name (ARN) that specifies the application.

" }, "resourceArn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) that specifies the resource.

" }, "actionTaken": { "shape": "SyncAction", "documentation": "

The results of the output if an application is associated with an ARN value, which could be syncStarted or None.

" } } }, "TagKey": { "type": "string", "max": 128, "min": 1, "pattern": "^([\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@]*)$" }, "TagKeyConfig": { "type": "string", "max": 128, "min": 0, "pattern": "^(?!\\s+$)[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*" }, "TagKeys": { "type": "list", "member": { "shape": "TagKey" }, "max": 50, "min": 0 }, "TagQueryConfiguration": { "type": "structure", "members": { "tagKey": { "shape": "TagKeyConfig", "documentation": "

Condition in the IAM policy that associates resources to an application.

" } }, "documentation": "

The definition of tagQuery. Specifies which resources are associated with an application.

" }, "TagResourceRequest": { "type": "structure", "required": [ "resourceArn", "tags" ], "members": { "resourceArn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) that specifies the resource.

", "location": "uri", "locationName": "resourceArn" }, "tags": { "shape": "Tags", "documentation": "

The new or modified tags for the resource.

" } } }, "TagResourceResponse": { "type": "structure", "members": {} }, "TagValue": { "type": "string", "max": 256, "pattern": "[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*" }, "Tags": { "type": "map", "key": { "shape": "TagKey" }, "value": { "shape": "TagValue" }, "max": 50, "min": 0 }, "Timestamp": { "type": "timestamp", "timestampFormat": "iso8601" }, "UntagResourceRequest": { "type": "structure", "required": [ "resourceArn", "tagKeys" ], "members": { "resourceArn": { "shape": "Arn", "documentation": "

The Amazon resource name (ARN) that specifies the resource.

", "location": "uri", "locationName": "resourceArn" }, "tagKeys": { "shape": "TagKeys", "documentation": "

A list of the tag keys to remove from the specified resource.

", "location": "querystring", "locationName": "tagKeys" } } }, "UntagResourceResponse": { "type": "structure", "members": {} }, "UpdateApplicationRequest": { "type": "structure", "required": [ "application" ], "members": { "application": { "shape": "ApplicationSpecifier", "documentation": "

The name, ID, or ARN of the application that will be updated.

", "location": "uri", "locationName": "application" }, "name": { "shape": "Name", "documentation": "

Deprecated: The new name of the application. The name must be unique in the region in which you are updating the application. Please do not use this field as we have stopped supporting name updates.

", "deprecated": true, "deprecatedMessage": "Name update for application is deprecated." }, "description": { "shape": "Description", "documentation": "

The new description of the application.

" } } }, "UpdateApplicationResponse": { "type": "structure", "members": { "application": { "shape": "Application", "documentation": "

The updated information of the application.

" } } }, "UpdateAttributeGroupRequest": { "type": "structure", "required": [ "attributeGroup" ], "members": { "attributeGroup": { "shape": "AttributeGroupSpecifier", "documentation": "

The name, ID, or ARN of the attribute group that holds the attributes to describe the application.

", "location": "uri", "locationName": "attributeGroup" }, "name": { "shape": "Name", "documentation": "

Deprecated: The new name of the attribute group. The name must be unique in the region in which you are updating the attribute group. Please do not use this field as we have stopped supporting name updates.

", "deprecated": true, "deprecatedMessage": "Name update for attribute group is deprecated." }, "description": { "shape": "Description", "documentation": "

The description of the attribute group that the user provides.

" }, "attributes": { "shape": "Attributes", "documentation": "

A JSON string in the form of nested key-value pairs that represent the attributes in the group and describes an application and its components.

" } } }, "UpdateAttributeGroupResponse": { "type": "structure", "members": { "attributeGroup": { "shape": "AttributeGroup", "documentation": "

The updated information of the attribute group.

" } } } }, "documentation": "

Amazon Web Services Service Catalog AppRegistry enables organizations to understand the application context of their Amazon Web Services resources. AppRegistry provides a repository of your applications, their resources, and the application metadata that you use within your enterprise.

" }