Privaten Pool konfigurieren

Für die Verarbeitung eines Livestreams müssen mehrere Komponenten verwaltet werden, die Aufgaben wie Aufnahme, Transcodierung und Multiplexing ausführen. Die Live Stream API verwaltet diese Komponenten und Ressourcen intern mithilfe von Pools. Ein Pool ist eine Verarbeitungseinheit, die jedem Google Cloud-Projekt pro Region zugewiesen ist und von allen Kanälen in einer bestimmten Region gemeinsam genutzt wird.

Wenn Sie eine Input-Ressource erstellen, erhalten Sie standardmäßig einen Endpunkt-URI mit einer öffentlichen IP-Adresse, an die Sie Ihre Eingabestreams senden können. Unabhängig davon, ob Sie von einem lokalen Netzwerk oder von einem Google Cloud-VPC-Netzwerk (Virtual Private Cloud) streamen, durchlaufen die Daten das öffentliche Internet, um den Endpunkt des Livestream-Dienstes zu erreichen.

Alternativ können Sie den Zugriff auf private Dienste auf den Livestreamdienst einrichten. Der Zugriff auf private Dienste ist eine sichere, private Verbindung zwischen Ihrem VPC-Netzwerk (Virtual Private Cloud) in Google Cloud und von Google verwalteten Diensten oder Diensten von Drittanbietern. Über diese Verbindung können VM-Instanzen in Ihrem VPC-Netzwerk über interne IP-Adressen mit diesen Diensten kommunizieren, ohne Traffic über das öffentliche Internet zugänglich zu machen. Wenn Sie in der Live Stream API den Zugriff auf private Dienste aktivieren, wird eine interne IP-Adresse aus Ihrem VPC-Netzwerk reserviert, die als Eingabeendpunkt verwendet werden soll. Das hat folgende Vorteile:

• Verbesserte Sicherheit: Mit dem privaten Dienstzugriff können Sie eine Verbindung zu den Eingabeendpunkten der Live Stream API herstellen, ohne den Traffic über das öffentliche Internet zugänglich zu machen. Dies kann dazu beitragen, Ihren Sicherheitsstatus zu verbessern und das Risiko einer Datenpanne zu verringern.
• Leistungssteigerung: Durch den Zugriff auf private Dienste kann die Leistung Ihrer Verbindungen verbessert werden, da das öffentliche Internet vermieden wird. Dies kann besonders nützlich sein, um eine geringere Latenz und einen höheren Durchsatz zu erzielen.

Sie können den Zugriff auf private Dienste auch mit Cloud Interconnect oder Cloud VPN koppeln, um eine private End-to-End-Verbindung zwischen Ihrem lokalen Netzwerk und dem Livestreamdienst bereitzustellen.

Hinweise

Damit Sie einen privaten Pool konfigurieren können, müssen Sie die folgenden Voraussetzungen erfüllen:

• Sie müssen ein vorhandenes VPC-Netzwerk haben, mit dem Sie eine Verbindung zum Netzwerk des Diensterstellers herstellen können. VM-Instanzen müssen dieses VPC-Netzwerk verwenden, um eine Verbindung zu Diensten über eine private Verbindung herzustellen.
• Sie müssen im VPC-Netzwerk den Zugriff auf private Dienste konfigurieren.
• Alle Kanäle in der Region müssen beendet werden. Andernfalls lehnt die Live Stream API die Anfrage zum Aktualisieren des Peering-Netzwerks des Pools ab.
• Alle Kanäle in der Region können nicht gestartet werden, während der Pool aktualisiert wird.

Privaten Pool konfigurieren

1. Achten Sie darauf, dass bereits ein Standardpool erstellt wurde. Der Standardpool für einen Standort wird erstellt, wenn Sie die erste Input-Ressource erstellen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer.
   • LOCATION: Verwenden Sie eine der unterstützten Regionen, in denen Sie bereits eine Eingabe erstellt haben
     Standorte anzeigen
     • us-central1
     • us-east1
     • us-east4
     • us-west1
     • us-west2
     • northamerica-northeast1
     • southamerica-east1
     • asia-east1
     • asia-east2
     • asia-northeast1
     • asia-southeast1
     • australia-southeast1
     • europe-west1
     • europe-west2
     • europe-west3
     • europe-west4

   Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

   curl (Linux, macOS oder Cloud Shell)

   Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus oder verwenden Cloud Shell, wo Sie automatisch in der gcloud-Befehlszeile angemeldet werden. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default"

   PowerShell (Windows)

   Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default" | Select-Object -Expand Content

   Sie sollten in etwa folgende JSON-Antwort erhalten:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
     "createTime": CREATE_TIME,
     "updateTime": UPDATE_TIME
   }
   

2. Aktualisieren Sie den Pool mit dem Namen des Peering-Netzwerks.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer.
   • LOCATION: der Standort des Standardpools; verwenden Sie eine der unterstützten Regionen.
     Standorte anzeigen
     • us-central1
     • us-east1
     • us-east4
     • us-west1
     • us-west2
     • northamerica-northeast1
     • southamerica-east1
     • asia-east1
     • asia-east2
     • asia-northeast1
     • asia-southeast1
     • australia-southeast1
     • europe-west1
     • europe-west2
     • europe-west3
     • europe-west4
   • NETWORK: die benutzerdefinierte Kennung für das Netzwerk im aktuellen Projekt für das Peering mit dem Dienst

   Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

   curl (Linux, macOS oder Cloud Shell)

   Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus oder verwenden Cloud Shell, wo Sie automatisch in der gcloud-Befehlszeile angemeldet werden. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "networkConfig": {
       "peeredNetwork": "projects/PROJECT_NUMBER/global/networks/NETWORK"
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig"

   PowerShell (Windows)

   Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "networkConfig": {
       "peeredNetwork": "projects/PROJECT_NUMBER/global/networks/NETWORK"
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig" | Select-Object -Expand Content

   Sie sollten in etwa folgende JSON-Antwort erhalten:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
       "createTime": CREATE_TIME,
       "target": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
       "verb": "update",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

   Die Anfrage initiiert einen lang andauernden Vorgang. Kopieren Sie die zurückgegebene OPERATION_ID zur Verwendung im nächsten Schritt.

3. Prüfen Sie mit der Methode projects.locations.operations.get, ob das Update abgeschlossen ist. Die Aktualisierung des Pools kann bis zu 30 Minuten dauern. Wenn die Antwort "done: false" enthält, wiederholen Sie die Anfrage, bis die Antwort "done: true" enthält.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer.
   • LOCATION: Der Standort, an dem sich Ihre Ressource befindet. Verwenden Sie eine der unterstützten Regionen.
     Standorte anzeigen
     • us-central1
     • us-east1
     • us-east4
     • us-west1
     • us-west2
     • northamerica-northeast1
     • southamerica-east1
     • asia-east1
     • asia-east2
     • asia-northeast1
     • asia-southeast1
     • australia-southeast1
     • europe-west1
     • europe-west2
     • europe-west3
     • europe-west4
   • OPERATION_ID: die ID für den Vorgang

   Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

   curl (Linux, macOS oder Cloud Shell)

   Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus oder verwenden Cloud Shell, wo Sie automatisch in der gcloud-Befehlszeile angemeldet werden. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

   PowerShell (Windows)

   Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

   Sie sollten in etwa folgende JSON-Antwort erhalten:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
       "createTime": CREATE_TIME,
       "endTime": END_TIME,
       "target": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
       "verb": "update",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.video.livestream.v1.Pool",
       "name": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
       "createTime": CREATE_TIME,
       "updateTime": UPDATE_TIME,
       "networkConfig": {
         "peeredNetwork": "projects/PROJECT_NUMBER/global/networks/NETWORK"
       }
     }
   

Nach dem Update sind alle URIs für vorhandene (und zukünftige) Eingabeendpunkte in der Region interne IP-Adressen, die aus dem angegebenen VPC-Netzwerk reserviert wurden. Listen Sie die Eingabeendpunkte auf, um die aktualisierten URIs zu sehen.

Hinweis: Nach einem Update dauert es länger als gewöhnlich, den ersten Kanal in einer Region zu starten.

Zum öffentlichen Pool wechseln

Wenn Sie zum öffentlichen Pool zurückkehren möchten, geben Sie in der Anfrage zum Aktualisieren des Pools einen leeren String als Namen des Peering-Netzwerks an.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

• PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer.
• LOCATION: der Standort des Standardpools; verwenden Sie eine der unterstützten Regionen.
  Standorte anzeigen
  • us-central1
  • us-east1
  • us-east4
  • us-west1
  • us-west2
  • northamerica-northeast1
  • southamerica-east1
  • asia-east1
  • asia-east2
  • asia-northeast1
  • asia-southeast1
  • australia-southeast1
  • europe-west1
  • europe-west2
  • europe-west3
  • europe-west4

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus oder verwenden Cloud Shell, wo Sie automatisch in der gcloud-Befehlszeile angemeldet werden. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

cat > request.json << 'EOF'
{
  "networkConfig": {
    "peeredNetwork": ""
  }
}
EOF

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig"

PowerShell (Windows)

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

@'
{
  "networkConfig": {
    "peeredNetwork": ""
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://livestream.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/pools/default?updateMask=networkConfig" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/pools/default",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Sie können noch einmal mit der Methode projects.locations.operations.get prüfen, ob das Update abgeschlossen ist.

Hinweis: Nach einem Update dauert es länger als gewöhnlich, den ersten Kanal in einer Region zu starten.