Przenoszenie zasobów do nowej grupy zasobów lub subskrypcji

  • Artykuł
  • Czas czytania: 12 min

W tym artykule pokazano, jak przenieść zasoby platformy Azure do innej subskrypcji platformy Azure lub innej grupy zasobów w ramach tej samej subskrypcji. Do przenoszenia zasobów możesz użyć witryny Azure Portal, programu Azure PowerShell, interfejsu wiersza polecenia platformy Azure lub interfejsu API REST.

Zarówno grupa źródłowa, jak i docelowa są blokowane na czas operacji przenoszenia. Operacje zapisu i usuwania na grupach zasobów są blokowane do momentu zakończenia przenoszenia. Ta blokada oznacza, że nie można dodawać, aktualizować ani usuwać zasobów w grupach zasobów. Nie oznacza to, że zasoby są zamrożone. Jeśli na przykład przenosisz do nowej grupy zasobów lub subskrypcji serwer logiczny usługi Azure SQL, jego bazy danych i inne zasoby zależne, aplikacje, które korzystają z funkcji tych baz danych, nie będą mieć przestoju. Nadal będą mogły wykonywać operacje odczytu i zapisu w tych bazach danych. Blokada może trwać maksymalnie cztery godziny, ale przeważnie przenoszenie zasobów trwa znacznie krócej.

Jeśli przeniesienie wymaga skonfigurowania nowych zasobów zależnych, wystąpi przerwa w działaniu tych usług do czasu ich ponownego skonfigurowania.

Przeniesienie zasobu powoduje jedynie przeniesienie go do nowej grupy zasobów lub subskrypcji. Operacja nie może zmienić lokalizacji zasobu.

Zmieniony identyfikator zasobu

Po przeniesieniu zasobu zmienisz jego identyfikator zasobu. Standardowy format identyfikatora zasobu to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. Po przeniesieniu zasobu do nowej grupy zasobów lub subskrypcji należy zmienić co najmniej jedną wartość w tej ścieżce.

Jeśli używasz identyfikatora zasobu w dowolnym miejscu, musisz zmienić wartość. Jeśli na przykład masz niestandardowy pulpit nawigacyjny w portalu, który odwołuje się do identyfikatora zasobu, musisz zaktualizować te wartości. Poszukaj wszystkich skryptów lub szablonów, które należy zaktualizować dla nowego identyfikatora zasobu.

Sporządzenie listy kontrolnej przed przeniesieniem zasobów

Przed przeniesieniem zasobu należy wykonać kilka ważnych czynności. Dzięki sprawdzeniu tych warunków można uniknąć błędów.

  1. Subskrypcje źródłowa i docelowa muszą być aktywne. Jeśli masz problem z włączeniem wyłączonego konta, utwórz wniosek o pomoc techniczną platformy Azure. Jako typ problemu wybierz Zarządzanie subskrypcją.

  2. Subskrypcje źródłowa i docelowa muszą istnieć w tej samej dzierżawie usługi Azure Active Directory. Aby sprawdzić, czy obie subskrypcje mają ten sam identyfikator dzierżawy, użyj programu Azure PowerShell lub wiersza polecenia platformy Azure.

    W przypadku programu Azure PowerShell użyj polecenia:

    (Get-AzSubscription -SubscriptionName <your-source-subscription>).TenantId
(Get-AzSubscription -SubscriptionName <your-destination-subscription>).TenantId

    W przypadku interfejsu wiersza polecenia platformy Azure użyj polecenia:

    az account show --subscription <your-source-subscription> --query tenantId
az account show --subscription <your-destination-subscription> --query tenantId

    Jeśli identyfikatory dzierżawy dla subskrypcji źródłowej i docelowej nie są takie same, użyj następujących metod, aby uzgodnić identyfikatory dzierżaw:

  3. Jeśli próbujesz przenieść zasoby do lub z partnera dostawcy rozwiązań w chmurze (CSP), zobacz Przenoszenie subskrypcji platformy Azure między subskrybentami i dostawcami CSP.

  4. Zasoby, które chcesz przenieść, muszą obsługiwać operację przenoszenia. Aby uzyskać listę zasobów, które obsługują przenoszenie zasobów, zobacz Obsługa operacji przenoszenia dla zasobów.

  5. Niektóre usługi mają określone ograniczenia lub wymagania dotyczące przenoszenia zasobów. Jeśli przenosisz dowolną z następujących usług, przed przeniesieniem sprawdź te wskazówki.

  6. Subskrypcja docelowa musi być zarejestrowana dla dostawcy przenoszonego zasobu. Jeśli nie, zostanie wyświetlony komunikat o błędzie informujący, że subskrypcja nie jest zarejestrowana dla typu zasobu. Ten błąd może wystąpić podczas przenoszenia zasobu do nowej subskrypcji, która nigdy nie była używana z tym typem zasobu.

    W przypadku programu PowerShell użyj następujących poleceń w celu pobrania stanu rejestracji:

    Set-AzContext -Subscription <destination-subscription-name-or-id>
Get-AzResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState

    Aby zarejestrować dostawcę zasobów, użyj:

    Register-AzResourceProvider -ProviderNamespace Microsoft.Batch

    W przypadku interfejsu wiersza polecenia platformy Azure użyj następujących poleceń w celu pobrania stanu rejestracji:

    az account set -s <destination-subscription-name-or-id>
az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table

    Aby zarejestrować dostawcę zasobów, użyj:

    az provider register --namespace Microsoft.Batch

  7. Przed przeniesieniem zasobów sprawdź limity przydziału dla subskrypcji, do której przenosisz zasoby. Jeśli przeniesienie zasobów oznacza, że subskrypcja przekroczy limity, musisz sprawdzić, czy możesz zażądać zwiększenia limitu przydziału. Aby uzyskać listę limitów i dowiedzieć się, jak zażądać ich zwiększenia, zobacz Limity, limity przydziału i ograniczenia subskrypcji i usług platformy Azure.

  8. Konto przenoszące zasoby musi mieć co najmniej następujące uprawnienia:

    • Microsoft.Resources/subscriptions/resourceGroups/moveResources/action w źródłowej grupie zasobów.
    • Microsoft.Resources/subscriptions/resourceGroups/write w docelowej grupie zasobów.

  9. Jeśli przeniesiesz zasób z rolą platformy Azure przypisaną bezpośrednio do tego zasobu lub zasobu podrzędnego, przypisanie roli nie zostanie przeniesione i zostanie oddzielone. Po przeniesieniu trzeba będzie ponownie utworzyć przypisanie roli. Po pewnym czasie oddzielone przypisanie roli zostanie automatycznie usunięte, ale zalecamy usunięcie przypisania roli przed przeniesieniem.

    Aby uzyskać informacje na temat zarządzania przypisaniami ról, zobacz Wyświetlanie listy przypisań ról platformy Azure i Przypisywanie ról platformy Azure.

  10. W przypadku przenoszenia między subskrypcjami zasób i jego zasoby zależne muszą znajdować się w tej samej grupie zasobów i muszą być przenoszone razem. Na przykład w przypadku maszyny wirtualnej z dyskami zarządzanymi maszyna wirtualna i dyski zarządzane muszą zostać przeniesione razem, wraz z innymi zasobami zależnymi.

    Jeśli przenosisz zasób do nowej subskrypcji, sprawdź, czy zasób ma jakiekolwiek zasoby zależne i czy znajdują się one tej samej grupie zasobów. Jeśli zasoby nie znajdują się w tej samej grupie zasobów, sprawdź, czy zasoby można połączyć w ramach tej samej grupy zasobów. Jeśli tak, przenieś wszystkie te zasoby do tej samej grupy zasobów przy użyciu operacji przenoszenia między grupami zasobów.

    Aby uzyskać więcej informacji, zobacz Scenariusz przenoszenia między subskrypcjami.

Scenariusz przenoszenia między subskrypcjami

Proces przenoszenia zasobów między subskrypcjami składa się z trzech etapów:

scenariusz przenoszenia między subskrypcjami

W celach ilustracyjnych uwzględniono tylko jeden zasób zależny.

  • Krok 1. Jeśli zasoby zależne są dystrybuowane między różnymi grupami zasobów, najpierw przenieś je do jednej grupy zasobów.
  • Krok 2. Przenoszenie zasobów i zasobów zależnych ze źródłowej subskrypcji do subskrypcji docelowej.
  • Krok 3. Opcjonalnie redystrybuj zasoby zależne do różnych grup zasobów w ramach subskrypcji docelowej.

Używanie portalu

Aby przenieść zasoby, wybierz grupę zasobów zawierającą te zasoby.

Wybierz zasoby, które chcesz przenieść. Aby przenieść wszystkie zasoby, zaznacz pole wyboru w górnej części listy. Możesz też wybrać zasoby pojedynczo.

wybieranie zasobów

Wybierz przycisk Przenieś.

opcje przenoszenia

Ten przycisk udostępnia trzy opcje:

Wybierz, czy przenosisz zasoby do nowej grupy zasobów, czy do nowej subskrypcji.

Źródłowa grupa zasobów jest ustawiana automatycznie. Określ docelową grupę zasobów. Jeśli przenosisz zasoby do nowej subskrypcji, określ również subskrypcję. Wybierz opcję Dalej.

wybieranie docelowej grupy zasobów

Portal sprawdza, czy zasoby można przenieść. Poczekaj na zakończenie walidacji.

Przenoszenie walidacji

Po pomyślnym zakończeniu walidacji wybierz pozycję Dalej.

Potwierdź, że musisz zaktualizować narzędzia i skrypty dla tych zasobów. Aby rozpocząć przenoszenie zasobów, wybierz pozycję Przenieś.

wybieranie miejsca docelowego

Po zakończeniu przenoszenia otrzymasz powiadomienie o wyniku.

wyświetlanie wyników przenoszenia

Korzystanie z programu Azure PowerShell

Walidacja

Aby przetestować scenariusz przenoszenia bez faktycznego przenoszenia zasobów, użyj polecenia Invoke-AzResourceAction . Użyj tego polecenia tylko wtedy, jeśli musisz wstępnie określić wyniki. Aby uruchomić tę operację, potrzebne są następujące elementy:

  • Identyfikator zasobu źródłowej grupy zasobów
  • Identyfikator zasobu docelowej grupy zasobów
  • Identyfikator zasobu każdego zasobu do przeniesienia
Invoke-AzResourceAction -Action validateMoveResources `
-ResourceId "/subscriptions/{subscription-id}/resourceGroups/{source-rg}" `
-Parameters @{ resources= @("/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}", "/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}", "/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}");targetResourceGroup = '/subscriptions/{subscription-id}/resourceGroups/{destination-rg}' }

Jeśli walidacja zakończy się pomyślnie, nie widzisz żadnych danych wyjściowych.

Jeśli walidacja nie powiedzie się, zostanie wyświetlony komunikat o błędzie opisujący, dlaczego nie można przenieść zasobów.

Move

Aby przenieść istniejące zasoby do innej grupy zasobów lub subskrypcji, użyj polecenia Move-AzResource . W poniższym przykładzie pokazano, jak przenieść kilka zasobów do nowej grupy zasobów.

$webapp = Get-AzResource -ResourceGroupName OldRG -ResourceName ExampleSite
$plan = Get-AzResource -ResourceGroupName OldRG -ResourceName ExamplePlan
Move-AzResource -DestinationResourceGroupName NewRG -ResourceId $webapp.ResourceId, $plan.ResourceId

Aby przejść do nowej subskrypcji, dołącz wartość parametru DestinationSubscriptionId .

Interfejs wiersza polecenia platformy Azure

Walidacja

Aby przetestować scenariusz przenoszenia bez faktycznego przenoszenia zasobów, użyj polecenia az resource invoke-action . Użyj tego polecenia tylko wtedy, jeśli musisz wstępnie określić wyniki. Aby uruchomić tę operację, potrzebne są następujące elementy:

  • Identyfikator zasobu źródłowej grupy zasobów
  • Identyfikator zasobu docelowej grupy zasobów
  • Identyfikator zasobu każdego zasobu do przeniesienia

W treści żądania użyj polecenia \" , aby uniknąć podwójnych cudzysłowów.

az resource invoke-action --action validateMoveResources \
  --ids "/subscriptions/{subscription-id}/resourceGroups/{source-rg}" \
  --request-body "{  \"resources\": [\"/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}\", \"/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}\", \"/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}\"],\"targetResourceGroup\":\"/subscriptions/{subscription-id}/resourceGroups/{destination-rg}\" }"

Jeśli walidacja zakończy się pomyślnie, zobaczysz:

{} Finished ..

Jeśli walidacja nie powiedzie się, zostanie wyświetlony komunikat o błędzie opisujący, dlaczego nie można przenieść zasobów.

Move

Aby przenieść istniejące zasoby do innej grupy zasobów lub subskrypcji, użyj polecenia az resource move . W parametrze --ids podaj rozdzielaną spacją listę identyfikatorów zasobów do przeniesienia.

W poniższym przykładzie pokazano, jak przenieść kilka zasobów do nowej grupy zasobów. Działa on podczas korzystania z interfejsu wiersza polecenia platformy Azure w terminalu powłoki Bash .

webapp=$(az resource show -g OldRG -n ExampleSite --resource-type "Microsoft.Web/sites" --query id --output tsv)
plan=$(az resource show -g OldRG -n ExamplePlan --resource-type "Microsoft.Web/serverfarms" --query id --output tsv)
az resource move --destination-group newgroup --ids $webapp $plan

W następnym przykładzie pokazano, jak uruchamiać te same polecenia w konsoli programu PowerShell .

$webapp=$(az resource show -g OldRG -n ExampleSite --resource-type "Microsoft.Web/sites" --query id --output tsv)
$plan=$(az resource show -g OldRG -n ExamplePlan --resource-type "Microsoft.Web/serverfarms" --query id --output tsv)
az resource move --destination-group newgroup --ids $webapp $plan

Aby przejść do nowej subskrypcji, podaj --destination-subscription-id parametr .

Korzystanie z interfejsu API REST

Walidacja

Operacja weryfikacji przenoszenia umożliwia przetestowanie scenariusza przenoszenia bez faktycznego przenoszenia zasobów. Użyj tej operacji, aby sprawdzić, czy przeniesienie zakończy się pomyślnie. Walidacja jest wywoływana automatycznie podczas wysyłania żądania przeniesienia. Tej operacji należy używać tylko wtedy, gdy trzeba wstępnie określać wyniki. Aby uruchomić tę operację, potrzebne są następujące elementy:

  • Nazwa źródłowej grupy zasobów
  • Identyfikator zasobu docelowej grupy zasobów
  • Identyfikator zasobu każdego zasobu do przeniesienia
  • Token dostępu dla konta

Wyślij następujące żądanie:

POST https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<source-group>/validateMoveResources?api-version=2019-05-10
Authorization: Bearer <access-token>
Content-type: application/json

Z treścią żądania:

{
 "resources": ["<resource-id-1>", "<resource-id-2>"],
 "targetResourceGroup": "/subscriptions/<subscription-id>/resourceGroups/<target-group>"
}

Jeśli żądanie jest poprawnie sformatowane, operacja zwraca:

Response Code: 202
cache-control: no-cache
pragma: no-cache
expires: -1
location: https://management.azure.com/subscriptions/<subscription-id>/operationresults/<operation-id>?api-version=2018-02-01
retry-after: 15
...

Kod stanu 202 wskazuje, że żądanie weryfikacji zostało zaakceptowane, ale nie określono jeszcze, czy operacja przenoszenia zakończy się pomyślnie. Wartość location zawiera adres URL używany do sprawdzania stanu długotrwałej operacji.

Aby sprawdzić stan, wyślij następujące żądanie:

GET <location-url>
Authorization: Bearer <access-token>

Mimo że operacja jest nadal uruchomiona, nadal otrzymujesz kod stanu 202. Przed próbą retry-after poczekaj liczbę sekund wskazanych w wartości. Jeśli operacja przenoszenia zostanie pomyślnie zweryfikowana, otrzymasz kod stanu 204. Jeśli walidacja przenoszenia zakończy się niepowodzeniem, zostanie wyświetlony komunikat o błędzie, taki jak:

{"error":{"code":"ResourceMoveProviderValidationFailed","message":"<message>"...}}

Move

Aby przenieść istniejące zasoby do innej grupy zasobów lub subskrypcji, użyj operacji Przenoszenie zasobów .

POST https://management.azure.com/subscriptions/{source-subscription-id}/resourcegroups/{source-resource-group-name}/moveResources?api-version={api-version}

W treści żądania należy określić docelową grupę zasobów i zasoby do przeniesienia.

{
 "resources": ["<resource-id-1>", "<resource-id-2>"],
 "targetResourceGroup": "/subscriptions/<subscription-id>/resourceGroups/<target-group>"
}

Często zadawane pytania

Pytanie: Moja operacja przenoszenia zasobów, która zwykle trwa kilka minut, jest uruchomiona przez prawie godzinę. Czy jest coś złego?

Przenoszenie zasobu jest złożoną operacją, która ma różne fazy. Może to obejmować nie tylko dostawcę zasobów zasobu, który próbujesz przenieść. Ze względu na zależności między dostawcami zasobów czas oczekiwania na zakończenie operacji w usłudze Azure Resource Manager wynosi 4 godziny. Ten okres daje dostawcom zasobów możliwość odzyskania po przejściowych problemach. Jeśli żądanie przeniesienia będzie mieć miejsce w ciągu wspomnianego okresu czterech godzin, operacja będzie kontynuowana i może nadal zakończyć się powodzeniem. W tym czasie źródłowe i docelowe grupy zasobów są blokowane, aby uniknąć problemów ze spójnością.

Pytanie: Dlaczego moja grupa zasobów jest zablokowana przez cztery godziny podczas przenoszenia zasobów?

Ukończenie żądania przeniesienia może trwać maksymalnie cztery godziny. Aby zapobiec modyfikacjom przenoszonych zasobów, podczas przenoszenia zasobów blokowane są zarówno źródłowe, jak i docelowe grupy zasobów.

Realizacja żądania przeniesienia obejmuje dwie fazy. W pierwszej fazie zasób jest przenoszony. W drugiej fazie są wysyłane powiadomienia do innych dostawców zasobów, którzy są zależni od przenoszonego zasobu. Grupa zasobów może zostać zablokowana na całe cztery godziny, jeśli dostawca zasobów ulegnie awarii w którejś z faz. W dozwolonym czasie usługa Resource Manager ponawia próbę wykonania kroku, który zakończył się niepowodzeniem.

Jeśli nie można przenieść zasobu w ciągu czterech godzin, usługa Resource Manager odblokuje obie grupy zasobów. Zasoby, które zostały pomyślnie przeniesione, będą znajdować się w docelowej grupie zasobów. Zasoby, które nie udało się przenieść, pozostają źródłową grupą zasobów.

Pytanie: Jakie są konsekwencje blokowania źródłowych i docelowych grup zasobów podczas przenoszenia zasobu?

Blokada uniemożliwia usunięcie grupy zasobów, utworzenie nowego zasobu w grupie zasobów oraz usunięcie dowolnego z zasobów związanych z przeniesieniem.

Na poniższej ilustracji przedstawiono komunikat o błędzie z Azure Portal, gdy użytkownik próbuje usunąć grupę zasobów, która jest częścią trwającego przenoszenia.

Przenoszenie komunikatu o błędzie podczas próby usunięcia

Pytanie: Jaki jest kod błędu "MissingMoveDependentResources"?

Podczas przenoszenia zasobu jego zasoby zależne muszą istnieć w docelowej grupie zasobów lub subskrypcji albo być uwzględnione w żądaniu przeniesienia. Kod błędu MissingMoveDependentResources jest wyświetlany, gdy zasób zależny nie spełnia tego wymagania. Komunikat o błędzie zawiera szczegółowe informacje o zasobie zależnym, który musi zostać uwzględniony w żądaniu przeniesienia.

Na przykład przeniesienie maszyny wirtualnej może wymagać przeniesienia siedmiu typów zasobów z trzema różnymi dostawcami zasobów. Ci dostawcy zasobów i typy to:

  • Microsoft.Compute

    • virtualMachines
    • disks

  • Microsoft.Network

    • networkInterfaces
    • publicIPAddresses
    • networkSecurityGroups
    • virtualNetworks

  • Microsoft.Storage

    • storageAccounts

Innym typowym przykładem jest przenoszenie sieci wirtualnej. Może być konieczne przeniesienie kilku innych zasobów skojarzonych z tą siecią wirtualną. Żądanie przeniesienia może wymagać przeniesienia publicznych adresów IP, tabel routingu, bram sieci wirtualnej, sieciowych grup zabezpieczeń i innych elementów.

Pytanie: Co oznacza kod błędu "RequestDisallowedByPolicy"?

Usługa Resource Manager weryfikuje żądanie przeniesienia przed podjęciem próby przeniesienia. Ta weryfikacja obejmuje sprawdzenie zasad zdefiniowanych dla zasobów związanych z przeniesieniem. Jeśli na przykład próbujesz przenieść magazyn kluczy, ale organizacja ma zasadę odmawiania utworzenia magazynu kluczy w docelowej grupie zasobów, weryfikacja zakończy się niepowodzeniem, a przeniesienie zostanie zablokowane. Zwrócony kod błędu to RequestDisallowedByPolicy.

Aby uzyskać więcej informacji na temat zasad, zobacz Co to jest Azure Policy?.

Pytanie: Dlaczego nie mogę przenieść niektórych zasobów na platformie Azure?

Obecnie nie wszystkie zasoby w pomoc techniczna platformy Azure przenieść. Aby uzyskać listę zasobów, które obsługują przenoszenie, zobacz Obsługa operacji przenoszenia dla zasobów.

Pytanie: Ile zasobów można przenieść w ramach jednej operacji?

Jeśli to możliwe, podziel duże przeniesienia na oddzielne operacje przenoszenia. Usługa Resource Manager natychmiast zwraca błąd, gdy jedna operacja obejmuje więcej niż 800 zasobów. Jednak przeniesienie mniej niż 800 zasobów może również zakończyć się niepowodzeniem w wyniku upłynięcia limitu czasu.

Pytanie: Jakie jest znaczenie błędu, którego zasób nie jest w stanie powodzenia?

Gdy zostanie wyświetlony komunikat o błędzie informujący, że nie można przenieść zasobu, ponieważ nie ma on stanu Powodzenie, w rzeczywistości może to być zasób zależny, który blokuje przeniesienie. Zazwyczaj kod błędu to MoveCannotProceedWithResourcesNotInSucceededState.

Jeśli źródło lub docelowa grupa zasobów zawiera sieć wirtualną, podczas przenoszenia sprawdzane są stany wszystkich zasobów zależnych dla sieci wirtualnej. Sprawdzanie obejmuje zasoby bezpośrednio i pośrednio zależne od sieci wirtualnej. Jeśli którykolwiek z tych zasobów ma stan niepowodzenia, przenoszenie jest blokowane. Jeśli na przykład maszyna wirtualna, która korzysta z tej sieci wirtualnej, uległa awarii, przenoszenie zostanie zablokowane. Przenoszenie jest blokowane nawet wtedy, gdy maszyna wirtualna nie jest jednym z przenoszonych zasobów i nie znajduje się w jednej z grup zasobów do przeniesienia.

Po otrzymaniu tego błędu masz dwie opcje. Przenieś zasoby do grupy zasobów, która nie ma sieci wirtualnej, lub skontaktuj się z pomocą techniczną.

Następne kroki

Aby uzyskać listę zasobów, które obsługują przenoszenie, zobacz Obsługa operacji przenoszenia dla zasobów.