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
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"
}
package armcontainerregistry_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerregistry/armcontainerregistry"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/969fd0c2634fbcc1975d7abe3749330a5145a97c/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2023-01-01-preview/examples/RegistryCheckNameAvailable.json
func ExampleRegistriesClient_CheckNameAvailability_registryCheckNameAvailable() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcontainerregistry.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewRegistriesClient().CheckNameAvailability(ctx, armcontainerregistry.RegistryNameCheckRequest{
Name: to.Ptr("myRegistry"),
Type: to.Ptr("Microsoft.ContainerRegistry/registries"),
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res.RegistryNameStatus = armcontainerregistry.RegistryNameStatus{
// NameAvailable: to.Ptr(true),
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ContainerRegistryManagementClient } = require("@azure/arm-containerregistry");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Checks whether the container registry name is available for use. The name must contain only alphanumeric characters, be globally unique, and between 5 and 50 characters in length.
*
* @summary Checks whether the container registry name is available for use. The name must contain only alphanumeric characters, be globally unique, and between 5 and 50 characters in length.
* x-ms-original-file: specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2023-01-01-preview/examples/RegistryCheckNameAvailable.json
*/
async function registryCheckNameAvailable() {
const subscriptionId =
process.env["CONTAINERREGISTRY_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
const registryNameCheckRequest = {
name: "myRegistry",
type: "Microsoft.ContainerRegistry/registries",
};
const credential = new DefaultAzureCredential();
const client = new ContainerRegistryManagementClient(credential, subscriptionId);
const result = await client.registries.checkNameAvailability(registryNameCheckRequest);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
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"
}
package armcontainerregistry_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerregistry/armcontainerregistry"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/969fd0c2634fbcc1975d7abe3749330a5145a97c/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2023-01-01-preview/examples/RegistryCheckNameNotAvailable.json
func ExampleRegistriesClient_CheckNameAvailability_registryCheckNameNotAvailable() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcontainerregistry.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewRegistriesClient().CheckNameAvailability(ctx, armcontainerregistry.RegistryNameCheckRequest{
Name: to.Ptr("myRegistry"),
Type: to.Ptr("Microsoft.ContainerRegistry/registries"),
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res.RegistryNameStatus = armcontainerregistry.RegistryNameStatus{
// Message: to.Ptr("The registry myRegistry is already in use."),
// NameAvailable: to.Ptr(false),
// Reason: to.Ptr("AlreadyExists"),
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ContainerRegistryManagementClient } = require("@azure/arm-containerregistry");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Checks whether the container registry name is available for use. The name must contain only alphanumeric characters, be globally unique, and between 5 and 50 characters in length.
*
* @summary Checks whether the container registry name is available for use. The name must contain only alphanumeric characters, be globally unique, and between 5 and 50 characters in length.
* x-ms-original-file: specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2023-01-01-preview/examples/RegistryCheckNameNotAvailable.json
*/
async function registryCheckNameNotAvailable() {
const subscriptionId =
process.env["CONTAINERREGISTRY_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
const registryNameCheckRequest = {
name: "myRegistry",
type: "Microsoft.ContainerRegistry/registries",
};
const credential = new DefaultAzureCredential();
const client = new ContainerRegistryManagementClient(credential, subscriptionId);
const result = await client.registries.checkNameAvailability(registryNameCheckRequest);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
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.
|