Udostępnij przez

Workspaces - Set Git Outbound Policy

Usługa:
Core
Wersja interfejsu API:
v1

Ustawia zasady ruchu wychodzącego Usługi Git dla określonego obszaru roboczego, gdy zasady ruchu wychodzącego są ustawione na wartość "Odmów".
Ten interfejs API używa metody PUT i zastąpi wszystkie ustawienia. W przypadkach, gdy obszar roboczy ogranicza zasady ruchu wychodzącego, administrator obszaru roboczego musi zezwolić na korzystanie z integracji z usługą Git w określonym obszarze roboczym. Jeśli w obszarze roboczym nie ma żadnych ograniczeń dotyczących ruchu wychodzącego, zmiana tej właściwości zakończy się niepowodzeniem i nie wpłynie to na ustawienie integracji usługi Git. Zawsze uruchamiaj najpierw polecenie Pobierz zasady ruchu wychodzącego Git i podaj pełne zasady w treści żądania.

Permissions

Obiekt wywołujący musi mieć rolę administratora obszaru roboczego.

Wymagane zakresy delegowane

Przestrzeń robocza.OdczytZapis.Wszystko

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość Support
User Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

PUT https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/networking/communicationPolicy/outbound/git

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.

Nagłówek żądania

Nazwa Wymagane Typ Opis
If-Match

string

Wartość ETag. Element ETag musi być określony w cudzysłowie. Jeśli zostanie podana wartość , wywołanie powiedzie się tylko wtedy, gdy element ETag zasobu jest zgodny z podanym elementem ETag.

Treść żądania

Nazwa Typ Opis
defaultAction

NetworkAccessRule

Domyślne zasady dostępu do obszaru roboczego z sieci publicznych.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zostało ukończone pomyślnie.

Nagłówki

ETag: string
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • UnknownError — wystąpił błąd.

Przykłady

Set workspace networking communication policy example

Przykładowe żądanie

PUT https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/networking/communicationPolicy/outbound/git

{
  "defaultAction": "Allow"
}

Przykładowa odpowiedź

Kod stanu:
200 
ETag: 0f8fad5b-d9cb-469f-a165-70867728950e

Definicje

Nazwa Opis
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
NetworkAccessRule

Domyślne zasady dostępu do obszaru roboczego z sieci publicznych.
NetworkRules

Zasady definiujące dostęp do/z obszaru roboczego do/z sieci publicznych.

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

NetworkAccessRule

Wyliczanie

Domyślne zasady dostępu do obszaru roboczego z sieci publicznych.

Wartość Opis
Allow

Zezwalaj na wszystkie połączenia.
Deny

Odmów wszystkich połączeń.

NetworkRules

Objekt

Zasady definiujące dostęp do/z obszaru roboczego do/z sieci publicznych.

Nazwa Typ Opis
defaultAction

NetworkAccessRule

Domyślne zasady dostępu do obszaru roboczego z sieci publicznych.