مشاركة عبر

RegistryArtifact interface

الحزمة:
@azure/container-registry

Artifact هو المصطلح العام للعناصر المخزنة في سجل الحاوية، ويمكن أن تتضمن صور Docker أو أنواع أدوات مبادرة حاوية مفتوحة (OCI) أخرى.

واجهة RegistryArtifact هي مساعد يجمع المعلومات والعمليات حول صورة أو أداة في سجل حاوية.

الخصائص

fullyQualifiedReference

مرجع مؤهل بالكامل للبيانات الاصطناعية.
registryEndpoint

نقطة نهاية Azure Container Registry.
repositoryName

اسم المستودع.

الأساليب

delete(DeleteArtifactOptions)

حذف أداة التسجيل هذه عن طريق حذف بيانها.
deleteTag(string, DeleteTagOptions)

حذف علامة. يؤدي ذلك إلى إزالة العلامة من البيانات الاصطناعية وبيانها.
getManifestProperties(GetManifestPropertiesOptions)

استرداد خصائص البيان الذي يعرف هذه الأداة بشكل فريد.
getTagProperties(string, GetTagPropertiesOptions)

استرداد خصائص العلامة المحددة.
listTagProperties(ListTagPropertiesOptions)

إرجاع مكرر غير متزامن قابل للتكبير لسرد العلامات التي تحدد هذه الأداة وخصائص كل منها بشكل فريد.

مثال على استخدام بناء جملة for-await-of:

const client = new ContainerRegistryClient(url, credentials);
const repository = client.getRepository(repositoryName);
const artifact = repository.getArtifact(digest)
for await (const tag of artifact.listTagProperties()) {
  console.log("tag: ", tag);
}

مثال على استخدام iter.next():

const iter = artifact.listTagProperties();
let item = await iter.next();
while (!item.done) {
  console.log("tag properties: ", item.value);
  item = await iter.next();
}

مثال على استخدام byPage():

const pages = artifact.listTagProperties().byPage({ maxPageSize: 2 });
let page = await pages.next();
let i = 1;
while (!page.done) {
 if (page.value) {
   console.log(`-- page ${i++}`);
   for (const tagProperties of page.value) {
     console.log(`  repository name: ${tagProperties}`);
   }
 }
 page = await pages.next();
}
updateManifestProperties(UpdateManifestPropertiesOptions)

يحدث خصائص بيان البيانات الاصطناعية.

مثال على الاستخدام:

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

تحديث خصائص علامة معينة.

مثال على الاستخدام:

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

تفاصيل الخاصية

fullyQualifiedReference

مرجع مؤهل بالكامل للبيانات الاصطناعية.

fullyQualifiedReference: string

قيمة الخاصية

string

registryEndpoint

نقطة نهاية Azure Container Registry.

registryEndpoint: string

قيمة الخاصية

string

repositoryName

اسم المستودع.

repositoryName: string

قيمة الخاصية

string

تفاصيل الأسلوب

delete(DeleteArtifactOptions)

حذف أداة التسجيل هذه عن طريق حذف بيانها.

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

المعلمات

options
DeleteArtifactOptions

المرتجعات

Promise<void>

deleteTag(string, DeleteTagOptions)

حذف علامة. يؤدي ذلك إلى إزالة العلامة من البيانات الاصطناعية وبيانها.

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

المعلمات

tag

string

اسم العلامة المراد حذفها.

options
DeleteTagOptions

المرتجعات

Promise<void>

getManifestProperties(GetManifestPropertiesOptions)

استرداد خصائص البيان الذي يعرف هذه الأداة بشكل فريد.

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

المعلمات

options
GetManifestPropertiesOptions

المرتجعات

Promise<ArtifactManifestProperties>

getTagProperties(string, GetTagPropertiesOptions)

استرداد خصائص العلامة المحددة.

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

المعلمات

tag

string

العلامة لاسترداد الخصائص.

options
GetTagPropertiesOptions

المرتجعات

Promise<ArtifactTagProperties>

listTagProperties(ListTagPropertiesOptions)

إرجاع مكرر غير متزامن قابل للتكبير لسرد العلامات التي تحدد هذه الأداة وخصائص كل منها بشكل فريد.

مثال على استخدام بناء جملة for-await-of:

const client = new ContainerRegistryClient(url, credentials);
const repository = client.getRepository(repositoryName);
const artifact = repository.getArtifact(digest)
for await (const tag of artifact.listTagProperties()) {
  console.log("tag: ", tag);
}

مثال على استخدام iter.next():

const iter = artifact.listTagProperties();
let item = await iter.next();
while (!item.done) {
  console.log("tag properties: ", item.value);
  item = await iter.next();
}

مثال على استخدام byPage():

const pages = artifact.listTagProperties().byPage({ maxPageSize: 2 });
let page = await pages.next();
let i = 1;
while (!page.done) {
 if (page.value) {
   console.log(`-- page ${i++}`);
   for (const tagProperties of page.value) {
     console.log(`  repository name: ${tagProperties}`);
   }
 }
 page = await pages.next();
}

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

المعلمات

options
ListTagPropertiesOptions

المرتجعات

PagedAsyncIterableIterator<ArtifactTagProperties, ArtifactTagProperties[], PageSettings>

updateManifestProperties(UpdateManifestPropertiesOptions)

يحدث خصائص بيان البيانات الاصطناعية.

مثال على الاستخدام:

const client = new ContainerRegistryClient(url, credential);
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>

المعلمات

options
UpdateManifestPropertiesOptions

المرتجعات

Promise<ArtifactManifestProperties>

updateTagProperties(string, UpdateTagPropertiesOptions)

تحديث خصائص علامة معينة.

مثال على الاستخدام:

const client = new ContainerRegistryClient(url, credential);
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>

المعلمات

tag

string

اسم العلامة لتحديث الخصائص على

options
UpdateTagPropertiesOptions

المرتجعات

Promise<ArtifactTagProperties>