Obtendo Metadados da Instância

Imagens Suportadas do IMDSv2

O IMDSv2 é suportado nas seguintes imagens de plataforma:

• Imagens do Oracle Autonomous Linux 8.x
• Imagens do Oracle Autonomous Linux 7.x liberadas em junho de 2020 ou depois
• Imagens do Oracle Linux 8.x, Oracle Linux 7.x e Oracle Linux 6.x lançadas em julho de 2020 ou depois

Outras imagens de plataforma, a maioria das imagens personalizadas e a maioria das imagens de Marketplace não suportam IMDSv2. Imagens personalizadas do Linux poderão suportar o IMDSv2 se o cloud-init for atualizado para a versão 20.3 ou mais recente e o Oracle Cloud Agent for atualizado para a versão 0.0.19 ou mais recente. Imagens personalizadas do Windows poderão suportar o IMDSv2 se o Oracle Cloud Agent for atualizado para a versão 1.0.0.0 ou mais recente; o cloudbase-init não suporta o IMDSv2.

Identificando Solicitações para os Pontos Finais Legados do IMDSv1

Para identificar os pontos finais do IMDS específicos, aos quais as solicitações estão sendo feitas e os agentes que estão fazendo as solicitações, use a métrica InstanceMetadataRequests.

Para identificar quais versões do IMDS estão ativadas para uma instância, execute uma das seguintes ações:

• Usando a Console:
  1. Abra o menu de navegação e clique em Compute. No serviço Compute, clique em Instâncias.
  2. Clique na instância em que você está interessado.
  3. Na seção Detalhes da Instância, ao lado de Serviço de metadados da instância, observe os números das versões.
• Usando a API: Use a operação GetInstance ou ListInstances. Na resposta, o atributo areLegacyImdsEndpointsDisabled no objeto InstanceOptions retornará false se o IMDSv1 e o IMDSv2 estiverem ativados para a instância. Ele retornará true se o IMDSv1 estiver desativado.

Desativando Solicitações para os Pontos Finais IMDSv1 Legados

Execute um dos seguintes procedimentos:

• Usando a Console:
  1. Abra o menu de navegação e clique em Compute. No serviço Compute, clique em Instâncias.
  2. Clique na instância em que você está interessado.
  3. Na seção Detalhes da Instância, ao lado de Serviço de metadados da instância, clique em Editar.
  4. Para Versão permitida do IMDS, selecione a opção Somente Versão 2.
  5. Clique em Salvar alterações.
• Usando a API: Use a operação UpdateInstance. No corpo da solicitação, no objeto InstanceOptions, informe o valor true para o atributo areLegacyImdsEndpointsDisabled.

Para obter os metadados das instâncias do Linux

1. Conecte-se a uma instância do Linux usando SSH.

2. Use o cURL para emitir uma solicitação GET para o URL de metadados da instância no qual você está interessado. Por exemplo:

   curl -H "Authorization: Bearer Oracle" -L http://169.254.169.254/opc/v2/instance/

Para obter os metadados das instâncias do Windows

As etapas para obter metadados em uma instância do Windows dependem de qual versão do serviço de metadados da instância você está solicitando metadados.

Para obter metadados da instância do Windows usando o IMDSv2:

1. Conecte-se a uma instância do Windows usando uma conexão de Área de Trabalho Remota.

2. Dependendo de sua versão do Windows incluir ou não o cURL, siga um destes procedimentos:

   • Se sua versão do Windows incluir o cURL, use o cURL para emitir uma solicitação GET para o URL de metadados da instância do seu interesse. Por exemplo:

     curl -H "Authorization: Bearer Oracle" -L http://169.254.169.254/opc/v2/instance/

   • Se sua versão do Windows não incluir o cURL, você poderá obter os metadados da instância no seu browser de internet. Navegue até o URL de metadados da instância do seu interesse e informe uma solicitação que inclua o cabeçalho de autorização. Consulte as instruções do browser para obter mais informações sobre como incluir cabeçalhos em uma solicitação. Talvez seja necessário instalar uma extensão de browser de terceiros que permita incluir cabeçalhos de solicitação.

Para obter metadados da instância do Windows usando o IMDSv1:

1. Conecte-se a uma instância do Windows usando uma conexão de Área de Trabalho Remota.
2. Abra um browser de Internet e, em seguida, navegue até o URL de metadados da instância em que você está interessado.

Repetições para Metadados da Instância

O serviço de metadados da instância passa regularmente por períodos curtos de inatividade para manutenção. Portanto, quando você tenta acessar os pontos finais do IMDS, eles podem não estar disponíveis. Como melhor prática, implemente a lógica de repetição ao acessar pontos finais do IMDS. A estratégia a seguir é recomendada: tente novamente até três vezes com um timeout de 30 segundos se receber uma resposta 404, 429 ou 5xx. Para obter mais informações e exemplos, consulte a documentação do SDK para Java.

Chaves de Metadados de uma Instância

Os metadados a seguir sobre uma instância estão disponíveis. Os caminhos são relativos a http://169.254.169.254/opc/v2/instance/.

Aqui está um exemplo de resposta que mostra todas as informações de uma instância:

{
  "availabilityDomain" : "EMIr:PHX-AD-1",
  "faultDomain" : "FAULT-DOMAIN-3",
  "compartmentId" : "ocid1.tenancy.oc1..exampleuniqueID",
  "displayName" : "my-example-instance",
  "hostname" : "my-hostname",
  "id" : "ocid1.instance.oc1.phx.exampleuniqueID",
  "image" : "ocid1.image.oc1.phx.exampleuniqueID",
  "metadata" : {
    "ssh_authorized_keys" : "example-ssh-key"
  },
  "region" : "phx",
  "canonicalRegionName" : "us-phoenix-1",
  "ociAdName" : "phx-ad-1",
  "regionInfo" : {
    "realmKey" : "oc1",
    "realmDomainComponent" : "oraclecloud.com",
    "regionKey" : "PHX",
    "regionIdentifier" : "us-phoenix-1"
  },
  "shape" : "VM.Standard.E3.Flex",
  "state" : "Running",
  "timeCreated" : 1600381928581,
  "agentConfig" : {
    "monitoringDisabled" : false,
    "managementDisabled" : false,
    "allPluginsDisabled" : false,
    "pluginsConfig" : [ {
      "name" : "OS Management Service Agent",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Custom Logs Monitoring",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Compute Instance Run Command",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Compute Instance Monitoring",
      "desiredState" : "ENABLED"
    } ]
  },
  "freeformTags": {
    "Department": "Finance"
  },
  "definedTags": {
    "Operations": {
      "CostCenter": "42"
    }
  }
}

Chaves de Metadados para VNICs Anexadas

Estão disponíveis a seguir os metadados sobre as VNICs anexadas à instância. Os caminhos são relativos a http://169.254.169.254/opc/v2/vnics/.

[ {
    "vnicId" : "ocid1.vnic.oc1.phx.exampleuniqueID",
    "privateIp" : "10.0.3.6",
    "vlanTag" : 11,
    "macAddr" : "00:00:00:00:00:01",
    "virtualRouterIp" : "10.0.3.1",
    "subnetCidrBlock" : "10.0.3.0/24",
    "nicIndex" : 0
}, {
    "vnicId" : "ocid1.vnic.oc1.phx.exampleuniqueID",
    "privateIp" : "10.0.4.3",
    "vlanTag" : 12,
    "macAddr" : "00:00:00:00:00:02",
    "virtualRouterIp" : "10.0.4.1",
    "subnetCidrBlock" : "10.0.4.0/24",
    "nicIndex" : 0
} ]

Chaves de Metadados para Volumes Anexados com Anexos Ativados para Multipath

Os metadados a seguir estão disponíveis sobre os anexos de volume ativados para multipath que são anexados à instância. Os caminhos são relativos a http://169.254.169.254/opc/v2/volumeAttachments/.

Este é um exemplo de resposta que mostra os anexos de volume ativados para multipath de uma instância:

[
  {
    "id": "ocid1.volumeattachment.oc1.phx.exampleuniqueID",
    "instanceId": "ocid1.instance.oc1.phx.exampleuniqueID",
    "volumeId": "ocid1.volume.oc1.phx.exampleuniqueID",
    "ipv4": "169.254.2.2",
    "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
    "port": 3260,
    "multipathDevices":
    [
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      }
    ]
  }
]