{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Registers credentials for a supported private external image registry so\nContainers can pull images from it. This endpoint does not create a registry\nor upload an image. Public Docker Hub images and images in the Cloudflare\nmanaged registry do not require this configuration.\n\nRefer to [Image management](https://developers.cloudflare.com/containers/platform-details/image-management/)\nfor supported registries and instructions for storing registry credentials.\n","properties":{"path":{"type":"object","properties":{"account_id":{"type":"string","examples":["account-123"],"description":"Account identifier."}},"required":["account_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/cc_ContainersCreateImageRegistryRequestBody"}},"required":["path","body"],"additionalProperties":false,"definitions":{"cc_ContainersCreateImageRegistryRequestBody":{"description":"Configuration for connecting Containers to a supported private external image\nregistry. See [Image management](https://developers.cloudflare.com/containers/platform-details/image-management/)\nfor supported providers and credential setup instructions.\n","type":"object","properties":{"auth":{"$ref":"#/definitions/cc_ContainersImageRegistryAuth"},"domain":{"description":"Hostname of the private registry, without a scheme or image path. Supported\nhostnames are `docker.io`, AWS ECR hostnames, and Google Artifact Registry\n`*-docker.pkg.dev` hostnames.\n","type":"string","examples":["docker.io"]},"is_public":{"description":"Omit this field or set it to `false`. Public Docker Hub images do not require\nregistry configuration and cannot be added with this endpoint.\n","type":"boolean","enum":[false]},"kind":{"description":"Registry provider. This must match `domain`: `DockerHub` for `docker.io`,\n`ECR` for AWS ECR, or `GAR` for Google Artifact Registry.\n","allOf":[{"$ref":"#/definitions/cc_ExternalRegistryKind"}]}},"required":["domain","auth","kind"]},"cc_ContainersImageRegistryAuth":{"description":"Credentials for authenticating to a private external image registry. Store the\nprivate credential in [Secrets Store](https://developers.cloudflare.com/secrets-store/)\nbefore calling the API. Refer to [Image management](https://developers.cloudflare.com/containers/platform-details/image-management/)\nfor the credential required by each supported registry provider.\n","type":"object","properties":{"private_credential":{"description":"A reference to the private registry credential in Secrets Store. The referenced\nsecret must have the `containers` scope. Raw secret values are not accepted.\n","allOf":[{"$ref":"#/definitions/cc_SecretsStoreRef"}]},"public_credential":{"description":"The non-secret part of the registry credential: an AWS access key ID for ECR,\na username for Docker Hub, or a service account email for Google Artifact Registry.\n","type":"string","examples":["example-user"]}},"required":["public_credential","private_credential"]},"cc_ExternalRegistryKind":{"description":"The type of external registry that is being configured.","type":"string","enum":["ECR","DockerHub","GAR"],"examples":["ECR"]},"cc_SecretsStoreRef":{"description":"Identifies an existing secret in [Secrets Store](https://developers.cloudflare.com/secrets-store/).\nThis reference does not contain or upload the secret value.\n","type":"object","properties":{"secret_name":{"description":"Name of the secret within the store.","type":"string","maxLength":255,"minLength":1,"pattern":"^[A-z0-9-_]+$","examples":["API_KEY"]},"store_id":{"description":"Identifier of the Secrets Store containing the secret.","type":"string","maxLength":32,"minLength":32,"pattern":"^[a-f0-9]{32}$","examples":["14758f1afd44c09b7992073ccf00b43d"]}},"required":["store_id","secret_name"]}}},"name":"Configure a private external image registry","id":"cloudflare.createimageregistry","example":{"path":{"account_id":"account-123"},"body":{"domain":"docker.io","auth":{"public_credential":"example-user","private_credential":{"store_id":"14758f1afd44c09b7992073ccf00b43d","secret_name":"API_KEY"}},"kind":"ECR"}},"maxRequests":1,"summary":false}}