Replications - List

Service:

Container Registry

API Version:

2023-01-01-preview

Elenchi tutte le repliche per il registro contenitori specificato.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/replications?api-version=2023-01-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
registryName	path	True	string	Nome del Registro contenitori. Regex pattern: ^[a-zA-Z0-9]*$
resourceGroupName	path	True	string	Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string uuid	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	ReplicationListResult	La richiesta ha avuto esito positivo; la richiesta è stata ben formata e ricevuta correttamente.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ReplicationList

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/replications?api-version=2023-01-01-preview

Go

package armcontainerregistry_test

import (
	"context"
	"log"

	"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/ReplicationList.json
func ExampleReplicationsClient_NewListPager() {
	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)
	}
	pager := clientFactory.NewReplicationsClient().NewListPager("myResourceGroup", "myRegistry", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.ReplicationListResult = armcontainerregistry.ReplicationListResult{
		// 	Value: []*armcontainerregistry.Replication{
		// 		{
		// 			Name: to.Ptr("myReplication"),
		// 			Type: to.Ptr("Microsoft.ContainerRegistry/registries/replications"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/replications/myReplication"),
		// 			Location: to.Ptr("eastus"),
		// 			Tags: map[string]*string{
		// 				"key": to.Ptr("value"),
		// 			},
		// 			Properties: &armcontainerregistry.ReplicationProperties{
		// 				ProvisioningState: to.Ptr(armcontainerregistry.ProvisioningStateSucceeded),
		// 				RegionEndpointEnabled: to.Ptr(true),
		// 				Status: &armcontainerregistry.Status{
		// 					DisplayStatus: to.Ptr("Ready"),
		// 					Message: to.Ptr("The replication is ready."),
		// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-03-01T23:15:37.0707808Z"); return t}()),
		// 				},
		// 				ZoneRedundancy: to.Ptr(armcontainerregistry.ZoneRedundancyDisabled),
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ContainerRegistryManagementClient } = require("@azure/arm-containerregistry");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists all the replications for the specified container registry.
 *
 * @summary Lists all the replications for the specified container registry.
 * x-ms-original-file: specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2023-01-01-preview/examples/ReplicationList.json
 */
async function replicationList() {
  const subscriptionId =
    process.env["CONTAINERREGISTRY_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["CONTAINERREGISTRY_RESOURCE_GROUP"] || "myResourceGroup";
  const registryName = "myRegistry";
  const credential = new DefaultAzureCredential();
  const client = new ContainerRegistryManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.replications.list(resourceGroupName, registryName)) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/replications/myReplication",
      "name": "myReplication",
      "type": "Microsoft.ContainerRegistry/registries/replications",
      "location": "eastus",
      "tags": {
        "key": "value"
      },
      "properties": {
        "provisioningState": "Succeeded",
        "status": {
          "displayStatus": "Ready",
          "message": "The replication is ready.",
          "timestamp": "2017-03-01T23:15:37.0707808Z"
        },
        "regionEndpointEnabled": true,
        "zoneRedundancy": "Disabled"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedByType	Tipo di identità che ha modificato l'ultima risorsa.
ProvisioningState	Stato di provisioning della risorsa.
Replication	Oggetto che rappresenta una replica per un registro contenitori.
ReplicationListResult	Risultato di una richiesta per elencare le repliche per un registro contenitori.
Status	Stato di una risorsa di Azure al momento della chiamata dell'operazione.
SystemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
ZoneRedundancy	Se la ridondanza della zona è abilitata per questo registro contenitori

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

lastModifiedByType

Tipo di identità che ha modificato l'ultima risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

ProvisioningState

Stato di provisioning della risorsa.

Nome	Tipo	Descrizione
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

Replication

Oggetto che rappresenta una replica per un registro contenitori.

Nome	Tipo	Valore predefinito	Descrizione
id	string		L'ID della risorsa.
location	string		Il percorso della risorsa. Non è possibile modificare questa operazione dopo la creazione della risorsa.
name	string		Nome della risorsa.
properties.provisioningState	ProvisioningState		Stato di provisioning della replica al momento della chiamata dell'operazione.
properties.regionEndpointEnabled	boolean	True	Specifica se l'endpoint a livello di area della replica è abilitato. Le richieste non verranno indirizzate a una replica il cui endpoint a livello di area è disabilitato, tuttavia i dati continueranno a essere sincronizzati con altre repliche.
properties.status	Status		Stato della replica al momento della chiamata dell'operazione.
properties.zoneRedundancy	ZoneRedundancy	Disabled	Se la ridondanza della zona è abilitata per la replica del Registro contenitori
systemData	SystemData		Metadati relativi alla creazione e all'ultima modifica della risorsa.
tags	object		Tag della risorsa.
type	string		Tipo di risorsa.

ReplicationListResult

Risultato di una richiesta per elencare le repliche per un registro contenitori.

Nome	Tipo	Descrizione
nextLink	string	URI che può essere usato per richiedere l'elenco successivo di repliche.
value	Replication[]	Elenco di repliche. Poiché questo elenco potrebbe essere incompleto, il campo nextLink deve essere usato per richiedere l'elenco successivo di repliche.

Status

Stato di una risorsa di Azure al momento della chiamata dell'operazione.

Nome	Tipo	Descrizione
displayStatus	string	Etichetta breve per lo stato.
message	string	Messaggio dettagliato per lo stato, inclusi avvisi e messaggi di errore.
timestamp	string	Timestamp quando lo stato è stato modificato nel valore corrente.

SystemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp della modifica delle risorse (UTC).
lastModifiedBy	string	Identità che ha modificato l'ultima risorsa.
lastModifiedByType	lastModifiedByType	Tipo di identità che ha modificato l'ultima risorsa.

ZoneRedundancy

Se la ridondanza della zona è abilitata per questo registro contenitori

Nome	Tipo	Descrizione
Disabled	string
Enabled	string