# Registry


## URI


`/v1/registries/name/registryName`

## HTTP methods


### GET


**Operation ID:** `DescribeRegistry`

Describes the registry.


**Path parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| registryName | String | True | The name of the schema registry. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | RegistryOutput | 200 response | 
| 400 | ErrorOutput | 400 response | 
| 401 | ErrorOutput | 401 response | 
| 403 | ErrorOutput | 403 response | 
| 404 | ErrorOutput | 404 response | 
| 500 | ErrorOutput | 500 response | 
| 503 | ErrorOutput | 503 response | 

### POST


**Operation ID:** `CreateRegistry`

Creates a registry.


**Path parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| registryName | String | True | The name of the schema registry. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 201 | RegistryOutput | 201 response | 
| 400 | ErrorOutput | 400 response | 
| 401 | ErrorOutput | 401 response | 
| 403 | ErrorOutput | 403 response | 
| 409 | ErrorOutput | 409 response | 
| 500 | ErrorOutput | 500 response | 
| 503 | ErrorOutput | 503 response | 

### PUT


**Operation ID:** `UpdateRegistry`


**Path parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| registryName | String | True | The name of the schema registry. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | RegistryOutput | 200 response | 
| 400 | ErrorOutput | 400 response | 
| 401 | ErrorOutput | 401 response | 
| 403 | ErrorOutput | 403 response | 
| 404 | ErrorOutput | 404 response | 
| 500 | ErrorOutput | 500 response | 
| 503 | ErrorOutput | 503 response | 

### DELETE


**Operation ID:** `DeleteRegistry`

Deletes a Registry.


**Path parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| registryName | String | True | The name of the schema registry. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 204 | None | 204 response | 
| 400 | ErrorOutput | 400 response | 
| 401 | ErrorOutput | 401 response | 
| 403 | ErrorOutput | 403 response | 
| 404 | ErrorOutput | 404 response | 
| 500 | ErrorOutput | 500 response | 
| 503 | ErrorOutput | 503 response | 

### OPTIONS



**Path parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| registryName | String | True | The name of the schema registry. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | None | 200 response | 

## Schemas


### Request bodies


#### POST schema
POST

```
{
  "Description": "string",
  "tags": {
  }
}
```

#### PUT schema
PUT

```
{
  "Description": "string"
}
```

### Response bodies


#### RegistryOutput schema
RegistryOutput

```
{
  "Description": "string",
  "RegistryName": "string",
  "RegistryArn": "string",
  "tags": {
  }
}
```

#### ErrorOutput schema
ErrorOutput

```
{
  "Message": "string",
  "Code": "string"
}
```

## Properties


### CreateRegistryInput



| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| Description | stringMinLength: 0MaxLength: 256 | False | A description of the registry to be created. | 
| tags | [Tags](#v1-registries-name-registryname-model-tags) | False | Tags to associate with the registry. | 

### ErrorOutput



| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| Code | string | True | The error code. | 
| Message | string | True | The message string of the error output. | 

### RegistryOutput



| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| Description | string | False | The description of the registry. | 
| RegistryArn | string | False | The ARN of the registry. | 
| RegistryName | string | False | The name of the registry. | 
| tags | [Tags](#v1-registries-name-registryname-model-tags) | False | Tags associated with the registry. | 

### Tags


Key-value pairs associated with a resource.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| `*` | string | False |  | 

### UpdateRegistryInput



| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| Description | stringMinLength: 0MaxLength: 256 | False | The description of the registry to update. |