Ventilatore:: GetStackOutput

La funzione intrinseca Fn::GetStackOutput restituisce il valore di un output da un altro stack. Al contrarioFn::ImportValue, questa funzione non richiede che lo stack di riferimento esporti esplicitamente il valore di output. Supporta anche riferimenti tra account e tra regioni.

Usa questa funzione quando devi fare riferimento agli output in pila tra AWS account o regioni o quando desideri fare riferimento agli output senza gestire esportazioni esplicite.

Dichiarazione

{
  "Fn::GetStackOutput": {
    "StackName": "stack-name",
    "OutputName": "output-name",
    "Region": "region",
    "RoleArn": "role-arn"
  }
}

Fn::GetStackOutput:
  StackName: stack-name
  OutputName: output-name
  Region: region
  RoleArn: role-arn

!GetStackOutput
  StackName: stack-name
  OutputName: output-name
  Region: region
  RoleArn: role-arn

# Do not use
!GetStackOutput
  StackName: !Ref MyStackNameParam
  OutputName: VpcId

# Use this instead
Fn::GetStackOutput:
  StackName: !Ref MyStackNameParam
  OutputName: VpcId

Parameters

Valore restituito

Il valore dell'output specificato dallo stack di riferimento.

Esempi

Stesso account, stessa regione

L'esempio seguente fa riferimento all'VpcIdoutput di uno stack denominato ProducerStack nello stesso account e nella stessa regione. Poiché no RoleArn è specificato Region o, CloudFormation utilizza la regione e il ruolo di esecuzione dello stack corrente.

{
  "Fn::GetStackOutput": {
    "StackName": "ProducerStack",
    "OutputName": "VpcId"
  }
}

Fn::GetStackOutput:
  StackName: ProducerStack
  OutputName: VpcId

Stesso account, regione diversa

L'esempio seguente fa riferimento all'VpcIdoutput di ProducerStack deployed inus-west-2, mentre lo stack di consumo si trova in una regione diversa. Il Region parametro indica di CloudFormation cercare il valore di riferimento in. us-west-2

{
  "Fn::GetStackOutput": {
    "StackName": "ProducerStack",
    "OutputName": "VpcId",
    "Region": "us-west-2"
  }
}

Fn::GetStackOutput:
  StackName: ProducerStack
  OutputName: VpcId
  Region: us-west-2

Cross-account

L'esempio seguente fa riferimento all'VpcIdoutput di ProducerStack in account. 111111111111 Lo stack di consumo è in conto222222222222. RoleArnspecifica un ruolo nell'account 111111111111 con cloudformation:DescribeStacks autorizzazioni, che deve essere assunto dal ruolo di esecuzione dello stack di consumo.

{
  "Fn::GetStackOutput": {
    "StackName": "ProducerStack",
    "OutputName": "VpcId",
    "RoleArn": "arn:aws:iam::111111111111:role/GetStackOutputRole"
  }
}

Fn::GetStackOutput:
  StackName: ProducerStack
  OutputName: VpcId
  RoleArn: arn:aws:iam::111111111111:role/GetStackOutputRole

Cross-account e Cross-region

L'esempio seguente fa riferimento a un output di uno stack in un account diverso e in una regione diversa. Vengono specificati entrambi Region i parametri RoleArn e.

{
  "Fn::GetStackOutput": {
    "StackName": "ProducerStack",
    "OutputName": "VpcId",
    "RoleArn": "arn:aws:iam::111111111111:role/GetStackOutputRole",
    "Region": "us-west-2"
  }
}

Fn::GetStackOutput:
  StackName: ProducerStack
  OutputName: VpcId
  RoleArn: arn:aws:iam::111111111111:role/GetStackOutputRole
  Region: us-west-2

Configurazione del ruolo IAM

Quando si utilizza il RoleArn parametro per i riferimenti tra account, il ruolo IAM deve disporre dell'autorizzazione a descrivere gli stack nell'account che contiene lo stack di riferimento:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:DescribeStacks"
      ],
      "Resource": "*"
    }
  ]
}

Il ruolo deve avere una politica di fiducia che conceda AssumeRole le autorizzazioni al ruolo di esecuzione dello stack di consumo:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::222222222222:role/CloudFormationExecutionRole"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Funzioni supportate

Le seguenti funzioni possono essere utilizzate all'interno dei valori dei parametri di Fn::GetStackOutput (ad esempio, per costruire l'or). StackName RoleArn Il valore di queste funzioni non può dipendere da una risorsa.

Fn::GetStackOutputesso stesso può essere utilizzato nelle seguenti posizioni del modello:

Vedi Limiti noti sotto per le posizioni che non sono ancora supportate.

Ad esempio, puoi usare Ref per passare un valore di parametro come nome dello stack:

Parameters:
  SourceStackName:
    Type: String

Resources:
  MyResource:
    Type: AWS::EC2::Instance
    Properties:
      SubnetId:
        Fn::GetStackOutput:
          StackName: !Ref SourceStackName
          OutputName: SubnetId

Limiti noti

I seguenti modelli di utilizzo non sono supportati in questa versione. Tutti restituiscono un InternalFailure errore. Il supporto per questi modelli verrà aggiunto in un futuro aggiornamento.

Usa Fn::GetStackOutput direttamente come valore della proprietà della risorsa o racchiudilo all'interno Fn::JoinFn::If, oppureFn::Select.

Gestione degli errori

CloudFormation convalida i Fn::GetStackOutput riferimenti durante le operazioni di creazione o aggiornamento dello stack. Di seguito sono riportati gli errori più comuni che si possono verificare:

Riferimenti tra le regioni us-east-1 e opt-in

È possibile che si verifichi un errore durante l'implementazione di un riferimento tra la us-east-1 regione e una regione opt-in. Per evitare tali errori, segui questa guida per aggiornare la compatibilità dei token per l'endpoint STS globale.

Usare Fn:: con GetStackOutput AWS Cloud Development Kit (AWS CDK)

Il AWS Cloud Development Kit (AWS CDK) (CDK) supporta Fn::GetStackOutput l'Fn.getStackOutput()intero metodo. Quando sono presenti riferimenti interregionali o interaccount tra stack CDK, ora il CDK può essere utilizzato in Fn::GetStackOutput modo nativo anziché generare risorse personalizzate con parametri SSM. Ciò semplifica i modelli sintetizzati ed elimina la necessità della soluzione alternativa precedente. crossRegionReferences

Per ulteriori informazioni, consulta il CDK API Reference.

Confronto con Fn: ImportValue

Da utilizzare Fn::ImportValue quando è necessaria una forte integrità referenziale all'interno dello stesso account e della stessa regione. Utilizzalo Fn::GetStackOutput quando hai bisogno di riferimenti tra account o tra aree geografiche o quando vuoi evitare di gestire esportazioni esplicite.

Best practice