Schulung
Modul
Implementación de recursos secundarios y de extensión mediante Bicep - Training
Obtenga información sobre cómo implementar recursos secundarios y de extensión, y hacer referencia a los recursos existentes, dentro del código de Bicep.
Beheben von Fehlern des Typs „Ressource nicht gefunden“
In diesem Artikel wird der angezeigte Fehler beschrieben, wenn eine Ressource während eines Vorgangs nicht gefunden wird. In der Regel tritt dieser Fehler auf, wenn Sie Ressourcen mit einer Bicep-Datei oder einer Azure Resource Manager-Vorlage (ARM-Vorlage) bereitstellen. Dieser Fehler wird auch angezeigt, wenn Sie Verwaltungsaufgaben ausführen und Azure Resource Manager die erforderliche Ressource nicht finden kann. Wenn Sie z. B. versuchen, Tags zu einer Ressource hinzuzufügen, die nicht vorhanden ist, wird dieser Fehler angezeigt.
Es gibt zwei Fehlercodes, die anzeigen, dass die Ressource nicht gefunden wurde. Der NotFound-Fehler gibt ein Ergebnis ähnlich dem folgenden zurück:
Output
Code=NotFound;
Message=Cannot find ServerFarm with name exampleplan.
Der ResourceNotFound-Fehler gibt ein Ergebnis ähnlich dem folgenden zurück:
Output
Code=ResourceNotFound;
Message=The Resource 'Microsoft.Storage/storageAccounts/{storage name}' under resource
group {resource group name} was not found.
Resource Manager muss die Eigenschaften für eine Ressource abrufen, kann die Ressource aber in Ihrem Abonnement nicht finden.
Wenn dieser Fehler beim Ausführen einer Verwaltungsaufgabe auftritt, überprüfen Sie die Werte, die Sie für die Ressource angegeben haben. Die drei zu überprüfenden Werte sind:
- Ressourcenname
- Ressourcengruppenname
- Subscription
Wenn Sie PowerShell oder Azure CLI verwenden, überprüfen Sie, ob Sie Befehle in dem Abonnement ausführen, das die Ressource enthält. Sie können das Abonnement mit Set-AzContext- oder az account set ändern. Viele Befehle bieten auch einen Abonnementparameter, mit dem Sie ein anderes Abonnement als den aktuellen Kontext angeben können.
Wenn Sie die Eigenschaften nicht überprüfen können, melden Sie sich beim Microsoft Azure-Portal an. Suchen Sie die Ressource, die Sie verwenden möchten, und untersuchen Sie den Ressourcennamen, die Ressourcengruppe und das Abonnement.
Wenn dieser Fehler beim Bereitstellen einer Vorlage auftritt, müssen Sie möglicherweise eine Abhängigkeit hinzufügen. Resource Manager optimiert die Bereitstellung, indem, sofern möglich, gleichzeitig Ressourcen erstellt werden.
Beim Bereitstellen einer Web-App muss z. B. der App Service-Plan vorhanden sein. Wenn Sie nicht angegeben haben, dass die Web-App vom App Service-Plan abhängig ist, erstellt Resource Manager beide Ressourcen zur gleichen Zeit. Bei der Web-App tritt ein Fehler auf, weil die App Service-Planressource nicht gefunden werden kann, da sie noch nicht vorhanden ist. Sie verhindern diesen Fehler, indem Sie eine Abhängigkeit in der Web-App festlegen.
Verwenden Sie eine implizite Abhängigkeit anstelle der resourceId-Funktion. Die Abhängigkeit wird unter Verwendung des symbolischen Namens und der ID-Eigenschaft einer Ressource erstellt.
Beispielsweise verwendet die serverFarmId-Eigenschaft der Web-App, um eine Abhängigkeit vom App Service-Plan zu erstellen, servicePlan.id.
Bicep
resource webApp 'Microsoft.Web/sites@2022-03-01' = {
properties: {
serverFarmId: servicePlan.id
}
}
resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' = {
name: hostingPlanName
...
Bei den meisten Bereitstellungen ist es nicht erforderlich, dependsOn zu verwenden, um eine explizite Abhängigkeit zu erstellen.
Vermeiden Sie es, Abhängigkeiten einzurichten, die nicht benötigt werden. Unnötige Abhängigkeiten verlängern die Dauer der Bereitstellung, da Ressourcen nicht parallel bereitgestellt werden. Außerdem könnten Sie Ringabhängigkeiten erstellen, die die Bereitstellung blockieren.
Wenn Abhängigkeitsprobleme auftreten, benötigen Sie Informationen zur Reihenfolge der Ressourcenbereitstellung. Im Portal können Sie die Reihenfolge der Bereitstellungsvorgänge anzeigen:
Melden Sie sich beim Portal an.
Wählen Sie in der Übersicht der Ressourcengruppe den Link für den Bereitstellungsverlauf aus.
Wählen Sie als Bereitstellungsnamen, den Sie überprüfen möchten, Verknüpfte Ereignisse aus.
Überprüfen Sie die Abfolge von Ereignissen für jede Ressource. Achten Sie auf den Status jedes Vorgangs und seinen Zeitstempel. Die folgende Abbildung zeigt beispielsweise drei parallel bereitgestellte Speicherkonten. Beachten Sie, dass die drei Speicherkontobereitstellungen zur selben Zeit gestartet werden.
Die nächste Abbildung zeigt drei Speicherkonten, die nicht parallel bereitgestellt werden. Das zweite Speicherkonto ist vom ersten Speicherkonto abhängig, und das dritte Speicherkonto ist vom zweiten Speicherkonto abhängig. Das erste Speicherkonto wird mit Gestartet, Akzeptiert und Erfolgreich bezeichnet, bevor das nächste gestartet wird.
Bicep verwendet den symbolischen Namen, um eine implizite Abhängigkeit von einer anderen Ressource zu erstellen. Das existing-Schlüsselwort (vorhanden) verweist auf eine bereitgestellte Ressource. Wenn sich eine vorhandene Ressource in einer anderen Ressourcengruppe als die Ressource befindet, die Sie bereitstellen möchten, schließen Sie den Bereich ein, und verwenden Sie die resourceGroup-Funktion.
In diesem Beispiel wird eine Web-App bereitgestellt, die einen vorhandenen App Service-Plan aus einer anderen Ressourcengruppe verwendet.
Bicep
resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' existing = {
name: hostingPlanName
scope: resourceGroup(rgname)
}
resource webApp 'Microsoft.Web/sites@2022-03-01' = {
name: siteName
properties: {
serverFarmId: servicePlan.id
}
}
Wenn Sie eine Ressource mit einer verwalteten Identität bereitstellen, müssen Sie warten, bis diese Ressource bereitgestellt wurde, bevor Sie Werte für die verwaltete Identität abrufen können. Verwenden Sie eine implizite Abhängigkeit für die Ressource, auf die die Identität angewendet wird. Mit diesem Ansatz wird sichergestellt, dass die Ressource und die verwaltete Identität bereitgestellt werden, bevor Resource Manager die Abhängigkeit verwendet.
Sie können die Prinzipal-ID und Mandanten-ID für eine verwaltete Identität abrufen, die auf einen virtuellen Computer angewandt wird. Wenn eine Ressource eines virtuellen Computers beispielsweise den symbolischen Namen vm hat, verwenden Sie die folgende Syntax:
Bicep
vm.identity.principalId
vm.identity.tenantId
Sie können den symbolischen Namen einer Ressource verwenden, um Werte von einer Ressource abzurufen. Sie können in derselben Ressourcengruppe oder einer anderen Ressourcengruppe auf ein Speicherkonto verweisen, indem Sie einen symbolischen Namen verwenden. Um einen Wert von einer bereitgestellten Ressource abzurufen, verwenden Sie das existing-Schlüsselwort (vorhanden). Befindet sich eine Ressource in einer anderen Ressourcengruppe, verwenden Sie scope mit der resourceGroup-Funktion. In den meisten Fällen wird die reference-Funktion (Verweis) nicht benötigt.
Im folgenden Beispiel wird auf ein vorhandenes Speicherkonto in einer anderen Ressourcengruppe verwiesen.
Bicep
resource stgAcct 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
name: stgname
scope: resourceGroup(rgname)
}
Wenn Sie eine Ressource löschen, wird die Ressource möglicherweise für kurze Zeit weiterhin im Portal angezeigt, ist aber nicht verfügbar. Wenn Sie die Ressource auswählen, informiert Sie eine Fehlermeldung darüber, dass die Ressource nicht gefunden wurde.
Aktualisieren Sie das Portal, und die gelöschte Ressource sollte aus Ihrer Liste der verfügbaren Ressourcen entfernt werden. Wenn eine gelöschte Ressource länger als ein paar Minuten noch als verfügbar angezeigt wird, wenden Sie sich an den Support.
Zusätzliche Ressourcen
Dokumentation
-
Administración de suscripciones de Azure: CLI de Azure
Obtenga información sobre los inquilinos, los usuarios y las suscripciones de Azure. Use la CLI de Azure para administrar las suscripciones, crear grupos de administración y bloquear suscripciones.
-
Solución de errores comunes de implementación de Azure - Azure Resource Manager
Solución de errores comunes de implementación de Azure para recursos que se implementan con archivos Bicep o plantillas de Azure Resource Manager (plantillas ARM).
-
Tipos y proveedores de recursos de Azure - Azure Resource Manager
Comprenda qué proveedores de recursos admiten Azure Resource Manager y sus esquemas, versiones de API disponibles y las regiones que pueden hospedar los recursos.