Partilhar via

RegistryArtifact interface

Pacote:
@azure/container-registry

Artifact é o termo geral para itens armazenados em um registro de contêiner e pode incluir imagens do Docker ou outros tipos de artefatos Open Container Initiative (OCI).

A interface RegistryArtifact é um auxiliar que agrupa informações e operações sobre uma imagem ou artefato em um registro de contêiner.

Propriedades

fullyQualifiedReference

referência totalmente qualificada do artefato.
registryEndpoint

O ponto de extremidade do Registro de Contêiner do Azure.
repositoryName

Nome do repositório.

Métodos

delete(DeleteArtifactOptions)

Exclui esse artefato do Registro excluindo seu manifesto.
deleteTag(string, DeleteTagOptions)

Exclui uma tag. Isso remove a tag do artefato e seu manifesto.
getManifestProperties(GetManifestPropertiesOptions)

Recupera as propriedades do manifesto que identifica exclusivamente esse artefato.
getTagProperties(string, GetTagPropertiesOptions)

Recupera as propriedades da tag especificada.
listTagProperties(ListTagPropertiesOptions)

Retorna um iterador iterável assíncrono para listar as tags que identificam exclusivamente esse artefato e as propriedades de cada um.

Exemplo usando sintaxe for-await-of:

import { ContainerRegistryClient } from "@azure/container-registry";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = "https://myregistryname.azurecr.io";
const repositoryName = "library/hello-world";
const artifactTagOrDigest = "latest";
const client = new ContainerRegistryClient(endpoint, new DefaultAzureCredential());

const artifact = client.getArtifact(repositoryName, artifactTagOrDigest);
for await (const tag of artifact.listTagProperties()) {
  console.log("tag: ", tag);
}
updateManifestProperties(UpdateManifestPropertiesOptions)

Atualiza as propriedades do manifesto do artefato.

Exemplo de uso:

import { ContainerRegistryClient } from "@azure/container-registry";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = "https://myregistryname.azurecr.io";
const repositoryName = "library/hello-world";
const artifactTagOrDigest = "latest";
const client = new ContainerRegistryClient(endpoint, new DefaultAzureCredential());

const artifact = client.getArtifact(repositoryName, artifactTagOrDigest);
const updated = await artifact.updateManifestProperties({
  canDelete: false,
  canList: false,
  canRead: false,
  canWrite: false,
});
updateTagProperties(string, UpdateTagPropertiesOptions)

Atualiza as propriedades de uma determinada tag.

Exemplo de uso:

import { ContainerRegistryClient } from "@azure/container-registry";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = "https://myregistryname.azurecr.io";
const repositoryName = "library/hello-world";
const artifactTagOrDigest = "latest";
const tag = "latest";
const client = new ContainerRegistryClient(endpoint, new DefaultAzureCredential());

const artifact = client.getArtifact(repositoryName, artifactTagOrDigest);
const updated = await artifact.updateTagProperties(tag, {
  canDelete: false,
  canList: false,
  canRead: false,
  canWrite: false,
});

Detalhes de Propriedade

fullyQualifiedReference

referência totalmente qualificada do artefato.

fullyQualifiedReference: string

Valor de Propriedade

string

registryEndpoint

O ponto de extremidade do Registro de Contêiner do Azure.

registryEndpoint: string

Valor de Propriedade

string

repositoryName

Nome do repositório.

repositoryName: string

Valor de Propriedade

string

Detalhes de Método

delete(DeleteArtifactOptions)

Exclui esse artefato do Registro excluindo seu manifesto.

function delete(options?: DeleteArtifactOptions): Promise<void>

Parâmetros

options
DeleteArtifactOptions

Devoluções

Promise<void>

deleteTag(string, DeleteTagOptions)

Exclui uma tag. Isso remove a tag do artefato e seu manifesto.

function deleteTag(tag: string, options?: DeleteTagOptions): Promise<void>

Parâmetros

tag

string

O nome da tag a ser excluída.

options
DeleteTagOptions

Devoluções

Promise<void>

getManifestProperties(GetManifestPropertiesOptions)

Recupera as propriedades do manifesto que identifica exclusivamente esse artefato.

function getManifestProperties(options?: GetManifestPropertiesOptions): Promise<ArtifactManifestProperties>

Parâmetros

options
GetManifestPropertiesOptions

Devoluções

Promise<ArtifactManifestProperties>

getTagProperties(string, GetTagPropertiesOptions)

Recupera as propriedades da tag especificada.

function getTagProperties(tag: string, options?: GetTagPropertiesOptions): Promise<ArtifactTagProperties>

Parâmetros

tag

string

a tag para recuperar propriedades.

options
GetTagPropertiesOptions

Opções para obter propriedades por etiqueta

Devoluções

Promise<ArtifactTagProperties>

listTagProperties(ListTagPropertiesOptions)

Retorna um iterador iterável assíncrono para listar as tags que identificam exclusivamente esse artefato e as propriedades de cada um.

Exemplo usando sintaxe for-await-of:

import { ContainerRegistryClient } from "@azure/container-registry";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = "https://myregistryname.azurecr.io";
const repositoryName = "library/hello-world";
const artifactTagOrDigest = "latest";
const client = new ContainerRegistryClient(endpoint, new DefaultAzureCredential());

const artifact = client.getArtifact(repositoryName, artifactTagOrDigest);
for await (const tag of artifact.listTagProperties()) {
  console.log("tag: ", tag);
}

function listTagProperties(options?: ListTagPropertiesOptions): PagedAsyncIterableIterator<ArtifactTagProperties, ArtifactTagProperties[], PageSettings>

Parâmetros

options
ListTagPropertiesOptions

Opções para listar etiquetas

Devoluções

PagedAsyncIterableIterator<ArtifactTagProperties, ArtifactTagProperties[], PageSettings>

updateManifestProperties(UpdateManifestPropertiesOptions)

Atualiza as propriedades do manifesto do artefato.

Exemplo de uso:

import { ContainerRegistryClient } from "@azure/container-registry";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = "https://myregistryname.azurecr.io";
const repositoryName = "library/hello-world";
const artifactTagOrDigest = "latest";
const client = new ContainerRegistryClient(endpoint, new DefaultAzureCredential());

const artifact = client.getArtifact(repositoryName, artifactTagOrDigest);
const updated = await artifact.updateManifestProperties({
  canDelete: false,
  canList: false,
  canRead: false,
  canWrite: false,
});

function updateManifestProperties(options: UpdateManifestPropertiesOptions): Promise<ArtifactManifestProperties>

Parâmetros

options
UpdateManifestPropertiesOptions

Devoluções

Promise<ArtifactManifestProperties>

updateTagProperties(string, UpdateTagPropertiesOptions)

Atualiza as propriedades de uma determinada tag.

Exemplo de uso:

import { ContainerRegistryClient } from "@azure/container-registry";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = "https://myregistryname.azurecr.io";
const repositoryName = "library/hello-world";
const artifactTagOrDigest = "latest";
const tag = "latest";
const client = new ContainerRegistryClient(endpoint, new DefaultAzureCredential());

const artifact = client.getArtifact(repositoryName, artifactTagOrDigest);
const updated = await artifact.updateTagProperties(tag, {
  canDelete: false,
  canList: false,
  canRead: false,
  canWrite: false,
});

function updateTagProperties(tag: string, options: UpdateTagPropertiesOptions): Promise<ArtifactTagProperties>

Parâmetros

tag

string

nome da tag para atualizar as propriedades em

options
UpdateTagPropertiesOptions

Devoluções

Promise<ArtifactTagProperties>