'2.0', 'metadata' => [ 'apiVersion' => '2025-12-01', 'auth' => [ 'aws.auth#sigv4', ], 'endpointPrefix' => 'agent-registry', 'protocol' => 'rest-json', 'protocols' => [ 'rest-json', ], 'serviceFullName' => 'Agent Registry', 'serviceId' => 'Agent Registry', 'signatureVersion' => 'v4', 'signingName' => 'agent-registry', 'uid' => 'agent-registry-2025-12-01', ], 'operations' => [ 'BatchGetDiscoverableRegistryRecord' => [ 'name' => 'BatchGetDiscoverableRegistryRecord', 'http' => [ 'method' => 'POST', 'requestUri' => '/discoverable-records-batch', 'responseCode' => 200, ], 'input' => [ 'shape' => 'BatchGetDiscoverableRegistryRecordRequest', ], 'output' => [ 'shape' => 'BatchGetDiscoverableRegistryRecordResponse', ], 'errors' => [ [ 'shape' => 'InternalServerException', ], [ 'shape' => 'AccessDeniedException', ], [ 'shape' => 'ResourceNotFoundException', ], [ 'shape' => 'ThrottlingException', ], [ 'shape' => 'UnauthorizedException', ], [ 'shape' => 'ValidationException', ], ], ], 'ListDiscoverableRegistryRecords' => [ 'name' => 'ListDiscoverableRegistryRecords', 'http' => [ 'method' => 'POST', 'requestUri' => '/registries/{registryId}/discoverable-records-list', 'responseCode' => 200, ], 'input' => [ 'shape' => 'ListDiscoverableRegistryRecordsRequest', ], 'output' => [ 'shape' => 'ListDiscoverableRegistryRecordsResponse', ], 'errors' => [ [ 'shape' => 'InternalServerException', ], [ 'shape' => 'AccessDeniedException', ], [ 'shape' => 'ResourceNotFoundException', ], [ 'shape' => 'ThrottlingException', ], [ 'shape' => 'UnauthorizedException', ], [ 'shape' => 'ValidationException', ], ], 'readonly' => true, ], 'SearchDiscoverableRegistryRecords' => [ 'name' => 'SearchDiscoverableRegistryRecords', 'http' => [ 'method' => 'POST', 'requestUri' => '/discoverable-records-search', 'responseCode' => 200, ], 'input' => [ 'shape' => 'SearchDiscoverableRegistryRecordsRequest', ], 'output' => [ 'shape' => 'SearchDiscoverableRegistryRecordsResponse', ], 'errors' => [ [ 'shape' => 'InternalServerException', ], [ 'shape' => 'AccessDeniedException', ], [ 'shape' => 'ResourceNotFoundException', ], [ 'shape' => 'ThrottlingException', ], [ 'shape' => 'UnauthorizedException', ], [ 'shape' => 'ValidationException', ], ], ], ], 'shapes' => [ 'A2aAgentCardDescriptor' => [ 'type' => 'structure', 'members' => [ 'data' => [ 'shape' => 'DescriptorData', ], 'dataSchemaVersion' => [ 'shape' => 'DataSchemaVersion', ], 'source' => [ 'shape' => 'DescriptorSource', ], ], ], 'AccessDeniedException' => [ 'type' => 'structure', 'members' => [ 'message' => [ 'shape' => 'NonBlankString', ], ], 'error' => [ 'httpStatusCode' => 403, 'senderFault' => true, ], 'exception' => true, ], 'AgUiDescriptor' => [ 'type' => 'structure', 'members' => [ 'source' => [ 'shape' => 'DescriptorSource', ], ], ], 'AgentSkillsAdditionalData' => [ 'type' => 'structure', 'members' => [ 'skillMd' => [ 'shape' => 'AgentSkillsMdDescriptor', ], ], ], 'AgentSkillsDefinitionDescriptor' => [ 'type' => 'structure', 'members' => [ 'data' => [ 'shape' => 'DescriptorData', ], 'dataSchemaVersion' => [ 'shape' => 'DataSchemaVersion', ], 'additionalData' => [ 'shape' => 'AgentSkillsAdditionalData', ], ], ], 'AgentSkillsMdDescriptor' => [ 'type' => 'structure', 'members' => [ 'data' => [ 'shape' => 'DescriptorData', ], 'dataSchemaVersion' => [ 'shape' => 'DataSchemaVersion', ], 'source' => [ 'shape' => 'DescriptorSource', ], ], ], 'BatchGetDiscoverableRegistryRecordError' => [ 'type' => 'structure', 'required' => [ 'registryId', 'recordId', 'errorCode', ], 'members' => [ 'registryId' => [ 'shape' => 'RegistryIdentifier', ], 'recordId' => [ 'shape' => 'RecordIdentifier', ], 'errorCode' => [ 'shape' => 'BatchGetDiscoverableRegistryRecordErrorCode', ], 'message' => [ 'shape' => 'String', ], ], ], 'BatchGetDiscoverableRegistryRecordErrorCode' => [ 'type' => 'string', 'enum' => [ 'RESOURCE_NOT_FOUND', 'ACCESS_DENIED', 'INTERNAL_ERROR', ], ], 'BatchGetDiscoverableRegistryRecordErrorList' => [ 'type' => 'list', 'member' => [ 'shape' => 'BatchGetDiscoverableRegistryRecordError', ], ], 'BatchGetDiscoverableRegistryRecordRequest' => [ 'type' => 'structure', 'required' => [ 'entries', ], 'members' => [ 'entries' => [ 'shape' => 'BatchGetDiscoverableRegistryRecordRequestEntriesList', ], ], ], 'BatchGetDiscoverableRegistryRecordRequestEntriesList' => [ 'type' => 'list', 'member' => [ 'shape' => 'RegistryRecordsEntry', ], 'max' => 1, 'min' => 1, ], 'BatchGetDiscoverableRegistryRecordResponse' => [ 'type' => 'structure', 'required' => [ 'registryRecords', 'errors', ], 'members' => [ 'registryRecords' => [ 'shape' => 'RegistryRecordSummaryList', ], 'errors' => [ 'shape' => 'BatchGetDiscoverableRegistryRecordErrorList', ], ], ], 'CustomDescriptor' => [ 'type' => 'structure', 'members' => [ 'data' => [ 'shape' => 'DescriptorData', ], ], ], 'DataSchemaVersion' => [ 'type' => 'string', 'max' => 255, 'min' => 1, ], 'DateTimestamp' => [ 'type' => 'timestamp', 'timestampFormat' => 'iso8601', ], 'Description' => [ 'type' => 'string', 'max' => 4096, 'min' => 1, 'sensitive' => true, ], 'DescriptorData' => [ 'type' => 'string', 'max' => 102400, 'min' => 1, 'sensitive' => true, ], 'DescriptorSource' => [ 'type' => 'structure', 'members' => [ 'fromUrl' => [ 'shape' => 'DescriptorSourceFromUrl', ], ], ], 'DescriptorSourceFromUrl' => [ 'type' => 'structure', 'required' => [ 'url', ], 'members' => [ 'url' => [ 'shape' => 'DescriptorSourceUrl', ], ], ], 'DescriptorSourceUrl' => [ 'type' => 'string', 'max' => 2048, 'min' => 1, 'pattern' => 'https://.*', ], 'DescriptorTypeList' => [ 'type' => 'list', 'member' => [ 'shape' => 'String', ], 'max' => 10, 'min' => 0, ], 'Descriptors' => [ 'type' => 'structure', 'members' => [ 'mcpServer' => [ 'shape' => 'McpServerDescriptor', ], 'a2aAgentCard' => [ 'shape' => 'A2aAgentCardDescriptor', ], 'agentSkillsDefinition' => [ 'shape' => 'AgentSkillsDefinitionDescriptor', ], 'custom' => [ 'shape' => 'CustomDescriptor', ], 'http' => [ 'shape' => 'HttpDescriptor', ], 'agui' => [ 'shape' => 'AgUiDescriptor', ], ], ], 'DiscoverableFilterValues' => [ 'type' => 'list', 'member' => [ 'shape' => 'FilterValue', ], 'max' => 10, 'min' => 1, ], 'DiscoverableRegistryRecordSummary' => [ 'type' => 'structure', 'required' => [ 'registryArn', 'recordArn', 'recordId', 'name', 'recordType', 'recordVersion', 'status', 'createdAt', 'updatedAt', ], 'members' => [ 'registryArn' => [ 'shape' => 'RegistryArn', ], 'recordArn' => [ 'shape' => 'RegistryRecordArn', ], 'recordId' => [ 'shape' => 'RegistryRecordId', ], 'name' => [ 'shape' => 'RegistryRecordName', ], 'description' => [ 'shape' => 'Description', ], 'displayName' => [ 'shape' => 'RegistryRecordDisplayName', ], 'recordType' => [ 'shape' => 'RecordType', ], 'recordVersion' => [ 'shape' => 'RegistryRecordVersion', ], 'status' => [ 'shape' => 'RegistryRecordStatus', ], 'createdAt' => [ 'shape' => 'DateTimestamp', ], 'updatedAt' => [ 'shape' => 'DateTimestamp', ], 'descriptorTypes' => [ 'shape' => 'DescriptorTypeList', ], ], ], 'DiscoverableRegistryRecordSummaryList' => [ 'type' => 'list', 'member' => [ 'shape' => 'DiscoverableRegistryRecordSummary', ], ], 'FilterValue' => [ 'type' => 'string', 'max' => 255, 'min' => 1, ], 'HttpDescriptor' => [ 'type' => 'structure', 'members' => [ 'source' => [ 'shape' => 'DescriptorSource', ], ], ], 'InternalServerException' => [ 'type' => 'structure', 'members' => [ 'message' => [ 'shape' => 'NonBlankString', ], ], 'error' => [ 'httpStatusCode' => 500, ], 'exception' => true, 'fault' => true, ], 'ListDiscoverableRegistryRecordsRequest' => [ 'type' => 'structure', 'required' => [ 'registryId', ], 'members' => [ 'registryId' => [ 'shape' => 'RegistryIdentifier', 'location' => 'uri', 'locationName' => 'registryId', ], 'maxResults' => [ 'shape' => 'ListDiscoverableRegistryRecordsRequestMaxResultsInteger', ], 'nextToken' => [ 'shape' => 'ListDiscoverableRegistryRecordsRequestNextTokenString', ], 'filters' => [ 'shape' => 'RegistryRecordFilterList', ], ], ], 'ListDiscoverableRegistryRecordsRequestMaxResultsInteger' => [ 'type' => 'integer', 'box' => true, 'max' => 100, 'min' => 1, ], 'ListDiscoverableRegistryRecordsRequestNextTokenString' => [ 'type' => 'string', 'max' => 4096, 'min' => 1, ], 'ListDiscoverableRegistryRecordsResponse' => [ 'type' => 'structure', 'required' => [ 'registryRecords', ], 'members' => [ 'registryRecords' => [ 'shape' => 'DiscoverableRegistryRecordSummaryList', ], 'nextToken' => [ 'shape' => 'String', ], ], ], 'McpServerAdditionalData' => [ 'type' => 'structure', 'members' => [ 'tools' => [ 'shape' => 'McpToolsDescriptor', ], ], ], 'McpServerDescriptor' => [ 'type' => 'structure', 'members' => [ 'data' => [ 'shape' => 'DescriptorData', ], 'dataSchemaVersion' => [ 'shape' => 'DataSchemaVersion', ], 'additionalData' => [ 'shape' => 'McpServerAdditionalData', ], 'source' => [ 'shape' => 'DescriptorSource', ], ], ], 'McpToolsDescriptor' => [ 'type' => 'structure', 'members' => [ 'data' => [ 'shape' => 'DescriptorData', ], 'dataSchemaVersion' => [ 'shape' => 'DataSchemaVersion', ], ], ], 'MetadataFilterExpression' => [ 'type' => 'structure', 'members' => [], 'document' => true, 'sensitive' => true, ], 'NonBlankString' => [ 'type' => 'string', 'max' => 2048, 'min' => 1, 'pattern' => '[\\s\\S]+', ], 'RecordIdentifier' => [ 'type' => 'string', 'max' => 2048, 'min' => 1, 'pattern' => '(arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/)?[a-zA-Z0-9]{12}', ], 'RecordType' => [ 'type' => 'string', 'enum' => [ 'MCP', 'AGENT', 'CUSTOM', 'SKILL', 'GATEWAY', ], ], 'RegistryArn' => [ 'type' => 'string', 'max' => 2048, 'min' => 46, 'pattern' => 'arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}', ], 'RegistryIdentifier' => [ 'type' => 'string', 'max' => 2048, 'min' => 1, 'pattern' => '(arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/)?[a-zA-Z0-9]{12,16}', ], 'RegistryRecordArn' => [ 'type' => 'string', 'max' => 2048, 'min' => 1, 'pattern' => 'arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/[a-zA-Z0-9]{12}', ], 'RegistryRecordDisplayName' => [ 'type' => 'string', 'max' => 255, 'min' => 1, ], 'RegistryRecordFilter' => [ 'type' => 'structure', 'required' => [ 'name', 'values', ], 'members' => [ 'name' => [ 'shape' => 'RegistryRecordFilterName', ], 'values' => [ 'shape' => 'DiscoverableFilterValues', ], ], ], 'RegistryRecordFilterList' => [ 'type' => 'list', 'member' => [ 'shape' => 'RegistryRecordFilter', ], 'max' => 10, 'min' => 0, ], 'RegistryRecordFilterName' => [ 'type' => 'string', 'enum' => [ 'recordType', 'descriptorType', ], ], 'RegistryRecordId' => [ 'type' => 'string', 'max' => 12, 'min' => 12, 'pattern' => '[a-zA-Z0-9]{12}', ], 'RegistryRecordName' => [ 'type' => 'string', 'max' => 255, 'min' => 1, 'pattern' => '[a-zA-Z0-9][a-zA-Z0-9_\\-\\.\\/]*', ], 'RegistryRecordStatus' => [ 'type' => 'string', 'enum' => [ 'DRAFT', 'PENDING_APPROVAL', 'APPROVED', 'REJECTED', 'DEPRECATED', 'CREATING', 'UPDATING', 'CREATE_FAILED', 'UPDATE_FAILED', ], ], 'RegistryRecordSummary' => [ 'type' => 'structure', 'required' => [ 'registryArn', 'recordArn', 'recordId', 'name', 'recordType', 'descriptors', 'recordVersion', 'status', 'createdAt', 'updatedAt', ], 'members' => [ 'registryArn' => [ 'shape' => 'RegistryArn', ], 'recordArn' => [ 'shape' => 'RegistryRecordArn', ], 'recordId' => [ 'shape' => 'RegistryRecordId', ], 'name' => [ 'shape' => 'RegistryRecordName', ], 'description' => [ 'shape' => 'Description', ], 'displayName' => [ 'shape' => 'RegistryRecordDisplayName', ], 'recordType' => [ 'shape' => 'RecordType', ], 'descriptors' => [ 'shape' => 'Descriptors', ], 'recordVersion' => [ 'shape' => 'RegistryRecordVersion', ], 'status' => [ 'shape' => 'RegistryRecordStatus', ], 'createdAt' => [ 'shape' => 'DateTimestamp', ], 'updatedAt' => [ 'shape' => 'DateTimestamp', ], ], ], 'RegistryRecordSummaryList' => [ 'type' => 'list', 'member' => [ 'shape' => 'RegistryRecordSummary', ], ], 'RegistryRecordVersion' => [ 'type' => 'string', 'max' => 255, 'min' => 1, 'pattern' => '[a-zA-Z0-9.-]+', ], 'RegistryRecordsEntry' => [ 'type' => 'structure', 'required' => [ 'registryId', 'recordIds', ], 'members' => [ 'registryId' => [ 'shape' => 'RegistryIdentifier', ], 'recordIds' => [ 'shape' => 'RegistryRecordsEntryRecordIdsList', ], ], ], 'RegistryRecordsEntryRecordIdsList' => [ 'type' => 'list', 'member' => [ 'shape' => 'RecordIdentifier', ], 'max' => 100, 'min' => 1, ], 'ResourceNotFoundException' => [ 'type' => 'structure', 'members' => [ 'message' => [ 'shape' => 'NonBlankString', ], ], 'error' => [ 'httpStatusCode' => 404, 'senderFault' => true, ], 'exception' => true, ], 'SearchDiscoverableRegistryRecordsRequest' => [ 'type' => 'structure', 'required' => [ 'searchQuery', 'registryIds', ], 'members' => [ 'searchQuery' => [ 'shape' => 'SearchQuery', ], 'registryIds' => [ 'shape' => 'SearchDiscoverableRegistryRecordsRequestRegistryIdsList', ], 'maxResults' => [ 'shape' => 'SearchDiscoverableRegistryRecordsRequestMaxResultsInteger', ], 'filters' => [ 'shape' => 'MetadataFilterExpression', ], ], ], 'SearchDiscoverableRegistryRecordsRequestMaxResultsInteger' => [ 'type' => 'integer', 'box' => true, 'max' => 20, 'min' => 1, ], 'SearchDiscoverableRegistryRecordsRequestRegistryIdsList' => [ 'type' => 'list', 'member' => [ 'shape' => 'RegistryIdentifier', ], 'max' => 1, 'min' => 1, ], 'SearchDiscoverableRegistryRecordsResponse' => [ 'type' => 'structure', 'required' => [ 'registryRecords', ], 'members' => [ 'registryRecords' => [ 'shape' => 'RegistryRecordSummaryList', ], ], ], 'SearchQuery' => [ 'type' => 'string', 'max' => 256, 'min' => 0, 'sensitive' => true, ], 'String' => [ 'type' => 'string', ], 'ThrottlingException' => [ 'type' => 'structure', 'members' => [ 'message' => [ 'shape' => 'NonBlankString', ], ], 'error' => [ 'httpStatusCode' => 429, 'senderFault' => true, ], 'exception' => true, ], 'UnauthorizedException' => [ 'type' => 'structure', 'members' => [ 'message' => [ 'shape' => 'NonBlankString', ], ], 'error' => [ 'httpStatusCode' => 401, 'senderFault' => true, ], 'exception' => true, ], 'ValidationException' => [ 'type' => 'structure', 'required' => [ 'message', 'reason', ], 'members' => [ 'message' => [ 'shape' => 'String', ], 'reason' => [ 'shape' => 'ValidationExceptionReason', ], 'fieldList' => [ 'shape' => 'ValidationExceptionFieldList', ], ], 'error' => [ 'httpStatusCode' => 400, 'senderFault' => true, ], 'exception' => true, ], 'ValidationExceptionField' => [ 'type' => 'structure', 'required' => [ 'name', 'message', ], 'members' => [ 'name' => [ 'shape' => 'String', ], 'message' => [ 'shape' => 'String', ], ], ], 'ValidationExceptionFieldList' => [ 'type' => 'list', 'member' => [ 'shape' => 'ValidationExceptionField', ], ], 'ValidationExceptionReason' => [ 'type' => 'string', 'enum' => [ 'CannotParse', 'FieldValidationFailed', 'IdempotentParameterMismatchException', 'EventInOtherSession', 'ResourceConflict', ], ], ],];