Utilisation de références d'images inter-comptes dans un catalogue privé dans la console

Les instances que vous mettez à disposition appartiennent à votre compte. Les images partagées sur votre compte via un catalogue privé peuvent appartenir à d'autres comptes. Lorsque vous mettez à disposition une instance à partir d'une image appartenant à un autre compte ou à partir d'un modèle d'instance qui spécifie une telle image, l'image appartient toujours à l'autre compte même si l'instance appartient à votre compte. Une référence à une telle image peut exister dans les détails de l'instance et des ressources associées. Par exemple, des détails sur son volume d'amorçage et toute image instantanée créée à partir de ce volume d'amorçage peuvent faire référence à cette image. Quelles que soient vos autorisations, vous ne pouvez pas accéder à l'image référencée par son ID ou son CRN et les tentatives échouent comme si l'image n'existait pas.

En outre, il est possible que l'image référencée ait le même nom qu'une image personnalisée dans votre compte. Mais ces noms d'image sont pour deux images différentes dans deux comptes différents. L'ID et le CRN identifient chacun de manière unique une image dans IBM Cloud®. Pour éviter une éventuelle extraction ou utilisation de la mauvaise image, lorsque vous coupez et collez l'identité d'une image en dehors de l'interface utilisateur, utilisez son ID ou son CRN, plutôt que son nom.

Utilisation de références d'image inter-comptes dans un catalogue privé dans l'interface de ligne de commande

Les instances que vous mettez à disposition appartiennent à votre compte. Les images partagées sur votre compte via un catalogue privé peuvent appartenir à d'autres comptes. Lorsque vous mettez à disposition une instance à partir d'une image appartenant à un autre compte ou à partir d'un modèle d'instance qui spécifie une telle image, l'image appartient toujours à l'autre compte même si l'instance appartient à votre compte. Une référence à une telle image peut exister dans les détails de l'instance et des ressources associées. Par exemple, des détails sur son volume d'amorçage et toute image instantanée créée à partir de ce volume d'amorçage peuvent faire référence à cette image. Quelles que soient vos autorisations, vous ne pouvez pas accéder à ce type d'image personnalisée par son ID et les tentatives échouent comme si l'image n'existait pas.

Les références d'image sont utilisées à différents endroits dans l'interface de ligne de commande. Par exemple, si vous utilisez la commande ibmcloud is instance pour extraire des données d'instance, vous voyez ce qui suit dans la sortie.

Image                                 ID                                          Name
                                      r006-6cab2dbd-4e57-4dc5-810b-b7366cb78999   test-image

Si vous tentez d'extraire des informations sur cette image à l'aide de son ID,

ibmcloud is image r006-6cab2dbd-4e57-4dc5-810b-b7366cb78999

Cette tentative échoue avec une erreur telle que l'exemple suivant:

FAILED
Response HTTP Status Code: 404
Error code: not_found
Error message: The requested resource does not exist, or cannot be accessed.
Error target name: id, type: parameter
Trace ID: d8b4d382-2993-4a89-a371-1db991b510d8

Cette erreur signifie que l'image n'existe pas dans votre compte. Si l'instance a été mise à disposition à l'aide d'une image de catalogue partagée dans un autre compte, cette sortie est celle que vous voyez toujours même si l'image existe dans le compte propriétaire.

En outre, il est possible que l'image référencée ait le même nom qu'une image personnalisée dans votre compte. Mais ces noms d'image sont pour deux images différentes dans deux comptes différents. Alors que l'interface de ligne de commande utilise à la fois l'ID et le nom pour identifier une image, seul l'ID identifie de manière unique une image dans IBM Cloud®.

Vérifiez que l'automatisation basée sur l'interface de ligne de commande gère correctement les échecs de recherche de références d'image et ne partez pas du principe que des images inaccessibles ont été supprimées, même si elles s'exécutent avec un accès complet à vos images. Pour éviter une éventuelle extraction ou utilisation d'une image incorrecte par Nom, indiquez l'ID image à la place.

Utilisation de références d'image inter-comptes dans un catalogue privé dans l'API

Les instances que vous mettez à disposition appartiennent à votre compte. Les images qui sont partagées sur votre compte via un catalogue privé peuvent appartenir à d'autres comptes. Lorsque vous mettez à disposition une instance à partir d'une image appartenant à un autre compte ou à partir d'un modèle d'instance qui spécifie une telle image, l'image appartient toujours à l'autre compte même si l'instance appartient à votre compte. Une référence à une telle image peut exister dans les détails de l'instance et des ressources associées. Par exemple, les détails relatifs à son volume d'amorçage et à tout instantané créé à partir de ce volume d'amorçage peuvent faire référence à cette image. Quelles que soient vos autorisations, vous ne pouvez pas accéder à une telle image par ses id, crn ou href et les tentatives échouent comme si l'image n'existait pas.

Dans l'API, une référence d'image apparaît dans des emplacements tels que les propriétés image des schémas de réponse Instance et BareMetalServerInitialization et dans les propriétés source_image des schémas de réponse Volume et Snapshot. L'exemple suivant utilise l'extraction des données d'instance pour illustrer comment cette erreur peut se produire.

curl -X GET "$vpc_api_endpoint/v1/instances/r006-44905aa4-119d-5622-00ce-face32b78999?version=2022-09-06&generation=2" -H "Authorization: Bearer $iam_token" | jq -r '(.image)'

L'exemple utilise jq comme analyseur syntaxique, un outil tiers sous licence MIT. Certains systèmes d'exploitation ne l'incluent pas par jq défaut. Installez-le avant jq utilisation ou remplacez-le par un autre analyseur JSON.

Lorsque vous exécutez cette commande, la sortie suivante s'affiche.

{
  "crn": "crn:v1:bluemix:public:is:us-south:a/123456::image:r006-6cab2dbd-4e57-4dc5-810b-b7366cb78999",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-6cab2dbd-4e57-4dc5-810b-b7366cb78999",
  "id": "r006-6cab2dbd-4e57-4dc5-810b-b7366cb78999",
  "name": "test-image"
}

Si vous tentez d'extraire des informations sur cette image à l'aide de son id,

curl -X GET "$vpc_api_endpoint/v1/images/r006-6cab2dbd-4e57-4dc5-810b-b7366cb78999?version=2022-09-06&generation=2" -H "Authorization: Bearer $iam_token"

cette tentative échoue avec le code d'état HTTP 404 (non trouvé). Ce code de statut signifie que l'image n'existe pas dans votre compte. Si l'instance a été mise à disposition à l'aide d'une image de catalogue partagée dans un autre compte, cette réponse est celle que vous obtenez toujours même si l'image existe toujours dans le compte propriétaire.

En outre, il est possible que l'image référencée ait le même nom qu'une image personnalisée dans votre compte. Mais ces noms d'image sont pour deux images différentes dans deux comptes différents. Les id, crn et href identifient chacune de manière unique une image dans IBM Cloud®.

Vérifiez que vos clients gèrent correctement les échecs de recherche de références d'image et ne supposez pas que des images inaccessibles ont été supprimées, même lorsqu'elles s'exécutent avec un accès complet à vos images. Pour éviter une éventuelle extraction ou utilisation de la mauvaise image par name, spécifiez l'image id, crn ou href à la place.

Utilisation de références d'image inter-comptes dans un catalogue privé dans Terraform

Les instances que vous mettez à disposition appartiennent à votre compte. Les images qui sont partagées sur votre compte via un catalogue privé peuvent appartenir à d'autres comptes. Lorsque vous mettez à disposition une instance à partir d'une image appartenant à un autre compte ou à partir d'un modèle d'instance qui spécifie une telle image, l'image appartient toujours à l'autre compte même si l'instance appartient à votre compte. Une référence à une telle image peut exister dans les détails de l'instance et des ressources associées. Par exemple, des détails sur son volume d'amorçage et toute image instantanée créée à partir de ce volume d'amorçage peuvent faire référence à cette image. Quelles que soient vos autorisations, vous ne pouvez pas accéder à ce type d'image personnalisée par son ID et les tentatives échouent comme si l'image n'existait pas.

Les références d'image sont utilisées à quelques endroits différents dans le terraform. Par exemple, si vous utilisez la source de données d'instance pour extraire des données d'instance, vous pouvez voir ce qui suit dans la réponse de la source de données.

"image": "r006-e0d3b6fb-5421-4421-9061-0ca9f79a4990"

Si vous tentez d'extraire des informations sur cette image à l'aide de sa source de données,

data "ibm_is_image" "example" {
  identifier = "r006-e0d3b6fb-5421-4421-9061-0ca9f79a4990"
}

Cette tentative échoue avec une erreur telle que l'exemple suivant:

Error: [ERROR] No image found with id  r006-e0d3b6fb-5421-4421-9061-0ca9f79a4990

Cette erreur signifie que l'image n'existe pas dans votre compte. Si l'instance a été mise à disposition à l'aide d'une image de catalogue partagée dans un autre compte, cette sortie est celle que vous voyez toujours même si l'image existe toujours dans le compte propriétaire.

En outre, il est possible que l'image référencée ait le même nom qu'une image personnalisée dans votre compte. Mais ces noms d'image sont pour deux images différentes dans deux comptes différents. Alors que le terraform utilise à la fois l'ID ou le nom pour identifier une image, seul l'ID identifie de manière unique une image dans IBM Cloud®. Pour éviter une éventuelle extraction ou utilisation d'une image incorrecte par son nom, indiquez l'ID de l'image à la place. Pour plus d'informations, voir Source de données d'image.