Jump to

• Request
• Response
• Examples

Create a new registry

post

/api/v2/registries/

To create a new registry entry, you pass the properties of the new registry entry using the body of the request.

Request

Supported Media Types

• application/json

Body ()

Body parameters

Root Schema : schema

Type: object

Show Source

• description: string
• email: string
• password: string
• url: string
• username: string

{
    "properties":{
        "description":{
            "type":"string"
        },
        "email":{
            "type":"string"
        },
        "password":{
            "type":"string"
        },
        "url":{
            "type":"string"
        },
        "username":{
            "type":"string"
        }
    },
    "required":[
        "description",
        "email",
        "password",
        "url",
        "username"
    ],
    "type":"object"
}

Security

• Authorization: apiKey
  Type: apiKey

Back to Top

Response

Supported Media Types

• application/json

200 Response

200 Response

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object items

{
    "items":{
        "properties":{
            "elapsed_time":{
                "type":"number"
            },
            "registry":{
                "properties":{
                    "description":{
                        "type":"string"
                    },
                    "email":{
                        "type":"string"
                    },
                    "password":{
                        "type":"string"
                    },
                    "registry_id":{
                        "type":"string"
                    },
                    "url":{
                        "type":"string"
                    },
                    "username":{
                        "type":"string"
                    }
                },
                "required":[
                    "description",
                    "email",
                    "password",
                    "registry_id",
                    "url",
                    "username"
                ],
                "type":"object"
            },
            "total_results":{
                "type":"integer"
            }
        },
        "required":[
            "elapsed_time",
            "registry",
            "total_results"
        ],
        "type":"object"
    }
}

Nested Schema : items

Type: object

Show Source

• elapsed_time: number
• registry: object registry
• total_results: integer

{
    "properties":{
        "elapsed_time":{
            "type":"number"
        },
        "registry":{
            "properties":{
                "description":{
                    "type":"string"
                },
                "email":{
                    "type":"string"
                },
                "password":{
                    "type":"string"
                },
                "registry_id":{
                    "type":"string"
                },
                "url":{
                    "type":"string"
                },
                "username":{
                    "type":"string"
                }
            },
            "required":[
                "description",
                "email",
                "password",
                "registry_id",
                "url",
                "username"
            ],
            "type":"object"
        },
        "total_results":{
            "type":"integer"
        }
    },
    "required":[
        "elapsed_time",
        "registry",
        "total_results"
    ],
    "type":"object"
}

Nested Schema : registry

Type: object

Show Source

• description: string
• email: string
• password: string
• registry_id: string
• url: string
• username: string

{
    "properties":{
        "description":{
            "type":"string"
        },
        "email":{
            "type":"string"
        },
        "password":{
            "type":"string"
        },
        "registry_id":{
            "type":"string"
        },
        "url":{
            "type":"string"
        },
        "username":{
            "type":"string"
        }
    },
    "required":[
        "description",
        "email",
        "password",
        "registry_id",
        "url",
        "username"
    ],
    "type":"object"
}

Default Response

Error Payload

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: string

{
    "items":{
        "type":"string"
    }
}

Back to Top

Examples

The following example shows how to create a new registry. You perform this task by submitting a POST request to the REST resource using cURL. For more information about cURL, see Use cURL.

Note: The command in this example uses the URL structure https://rest_server_url/resource-path, where rest_server_url is the manager node for the Oracle Cloud Container instance. See Send Requests for the appropriate URL structure to use for Oracle Public Cloud.

cURL Command

curl -sk 
     -X "POST" 
     -H "Authorization: Bearer b39f09c71c297f1d" 
     "https://rest_server_url/api/v2/registries/" 
     -d '{"url":"docker.example.com",
          "email":"[e-mail]",
          "username":"admin",
          "password":"password",
          "description":"My Example Registry"}'

Example of Response Body

{
  "elapsed_time": 0.036365006000000005,
  "registry": {
    "registry_id": "5e8fb5828d48c61a",
    "url": "docker.example.com",
    "email": "[e-mail]",
    "username": "admin",
    "password": "",
    "description": "Oracle Example Registry"
  },
  "total_results": 1
}

Back to Top