Dela via


Registries - Check Name Availability

Kontrollerar om containerregistrets namn är tillgängligt för användning. Namnet får bara innehålla alfanumeriska tecken, vara globalt unikt och mellan 5 och 50 tecken långt.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerRegistry/checkNameAvailability?api-version=2023-01-01-preview

URI-parametrar

Name I Obligatorisk Typ Description
subscriptionId
path True

string

uuid

ID för målprenumerationen. Värdet måste vara ett UUID.

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Obligatorisk Typ Description
name True

string

Namnet på containerregistret.

type True

ContainerRegistryResourceType

Resurstypen för containerregistret. Det här fältet måste vara inställt på Microsoft.ContainerRegistry/registries.

Svar

Name Typ Description
200 OK

RegistryNameStatus

Begäran lyckades. begäran var väl utformad och togs emot korrekt.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

RegistryCheckNameAvailable
RegistryCheckNameNotAvailable

RegistryCheckNameAvailable

Exempelbegäran

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerRegistry/checkNameAvailability?api-version=2023-01-01-preview

{
  "name": "myRegistry",
  "type": "Microsoft.ContainerRegistry/registries"
}

Exempelsvar

{
  "nameAvailable": true
}

RegistryCheckNameNotAvailable

Exempelbegäran

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerRegistry/checkNameAvailability?api-version=2023-01-01-preview

{
  "name": "myRegistry",
  "type": "Microsoft.ContainerRegistry/registries"
}

Exempelsvar

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "The registry myRegistry is already in use."
}

Definitioner

Name Description
ContainerRegistryResourceType

Resurstypen för containerregistret. Det här fältet måste vara inställt på Microsoft.ContainerRegistry/registries.

RegistryNameCheckRequest

En begäran om att kontrollera om ett containerregisternamn är tillgängligt.

RegistryNameStatus

Resultatet av en begäran om att kontrollera tillgängligheten för ett containerregisternamn.

ContainerRegistryResourceType

Resurstypen för containerregistret. Det här fältet måste vara inställt på Microsoft.ContainerRegistry/registries.

Name Typ Description
Microsoft.ContainerRegistry/registries

string

RegistryNameCheckRequest

En begäran om att kontrollera om ett containerregisternamn är tillgängligt.

Name Typ Description
name

string

Namnet på containerregistret.

type

ContainerRegistryResourceType

Resurstypen för containerregistret. Det här fältet måste vara inställt på Microsoft.ContainerRegistry/registries.

RegistryNameStatus

Resultatet av en begäran om att kontrollera tillgängligheten för ett containerregisternamn.

Name Typ Description
message

string

Om det finns något felmeddelande som innehåller mer information om orsaken till att namnet inte är tillgängligt.

nameAvailable

boolean

Det värde som anger om namnet är tillgängligt.

reason

string

Om det finns någon orsak till att namnet inte är tillgängligt.