Nachdem Sie eine Online-oder Stapelbereitstellung erstellt haben, können Sie Ihre Bereitstellungsdetails und die Assets, die Ihrer Bereitstellung zugeordnet sind, trotzdem aktualisieren.
Weitere Informationen finden Sie unter:
- Bereitstellungsdetails aktualisieren
- Assets aktualisieren, die einer Implementierung zugeordnet sind
Bereitstellungsdetails aktualisieren
Sie können allgemeine Bereitstellungsdetails wie Bereitstellungsname, Beschreibung, Metadaten und Tags mit einer der folgenden Methoden aktualisieren:
Vorbereitende Schritte
Sie müssen Ihre Anmeldedaten für die Aufgabe einrichten, indem Sie einen API-Schlüssel erstellen. Weitere Informationen finden Sie unter Verwalten von Berechtigungsnachweisen für Aufgaben.
Bereitstellungsdetails über die Benutzerschnittstelle aktualisieren
Klicken Sie auf der Registerkarte Bereitstellungen Ihres Bereitstellungsbereichs auf das Aktionsmenü für die Bereitstellung und wählen Sie Einstellungen bearbeitenaus.
Aktualisieren Sie die Details und klicken Sie dann auf Speichern.
Tipp: Sie können eine Bereitstellung auch über das Informationsblatt für die Bereitstellung aktualisieren.
Bereitstellungsdetails mit dem API-Befehl 'Patch' aktualisieren
Verwenden Sie den Befehl watsonx.ai Runtime API Patch, um die Bereitstellungsdetails zu aktualisieren.
curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment id>?space_id=<space id>&version=<YYYY-MM-DD>' \n--data-raw '[
{
"op": "<operation type>",
"path": "<path>",
"value": "<new value>"
},
{
"op": "<operation type>",
"path": "<path>",
"value": "<new value>"
}
]'
Geben Sie beispielsweise Folgendes ein, um eine Beschreibung für die Bereitstellung zu aktualisieren:
curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment_id>?space_id=<space_id>&version=<YYYY-MM-DD>' \n--data-raw '[
{
"op": "replace",
"path": "/description",
"value": "<new_description>"
},
]'
Anmerkungen:
- Verwenden Sie
"add"
,"remove"
oder"replace"
für<operation type>
.
Assets aktualisieren, die einer Bereitstellung zugeordnet sind
Nach der Erstellung einer Online- oder Batchbereitstellung können Sie das bereitgestellte Asset über denselben Endpunkt aktualisieren. Wenn Sie beispielsweise ein Modell mit besserer Leistung haben, können Sie das bereitgestellte Modell durch die verbesserte Version ersetzen. Wenn die Aktualisierung abgeschlossen ist, ist das neue Modell über den REST-API-Endpunkt verfügbar.
Stellen Sie vor der Aktualisierung eines Assets sicher, dass die folgenden Bedingungen zutreffen:
Das Framework des neuen Modells ist mit dem vorhandenen bereitgestellten Modell kompatibel.
Das Eingabeschema ist vorhanden und stimmt mit dem neuen und dem bereitgestellten Modell überein.
Vorsicht: Wenn Sie diese Bedingungen nicht erfüllen, kann dies zum Fehlschlagen der Bereitstellung führen.Weitere Informationen finden Sie unter Asset über die Benutzerschnittstelle des Bereitstellungsbereichs aktualisieren.
Weitere Informationen finden Sie unter Asset mithilfe des Patch-API-Befehls Aktualisieren.
Asset über die Benutzerschnittstelle des Bereitstellungsbereichs aktualisieren
- Klicken Sie auf der Registerkarte Implementierungen Ihres Bereitstellungsbereichs auf das Aktionsmenü für die Implementierung und wählen Sie Bearbeitenaus.
- Klicken Sie auf Asset ersetzen. Wählen Sie im Dialogfenster Anlage auswählen die Anlage aus, durch die Sie die aktuelle Anlage ersetzen möchten, und klicken auf Anlage auswählen.
- Klicken Sie auf Speichern.
Asset mithilfe des Patch-API-Befehls aktualisieren
Verwenden Sie den Befehl " Patch
" watsonx.ai Runtime API, um jedes unterstützte Asset zu aktualisieren.
Verwenden Sie die folgende Methode, um ein Modell für eine Onlinebereitstellung zu aktualisieren.
curl -X PATCH '<deployment endpoint url>/ml/v4/models/<model_id>?space_id=<space_id>&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[
{
"op": "<operation type>",
"path": "<path>",
"value": "<new value>"
},
{
"op": "<operation type>",
"path": "<path>",
"value": "<new value>"
}
]'
Beispiel: Patch für ein Modell mit der ID 6f01d512-fe0f-41cd-9a52-1e200c525c84
in der Bereichs-ID f2ddb8ce-7b10-4846-9ab0-62454a449802
:
curl -X PATCH '<deployment endpoint url>/ml/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[
{
"op":"replace",
"path":"/asset",
"value":{
"id":"6f01d512-fe0f-41cd-9a52-1e200c525c84",
"rev":"1"
}
}
]'
Eine erfolgreiche Ausgabeantwort sieht wie folgt aus:
{
"entity": {
"asset": {
"href": "/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802",
"id": "6f01d512-fe0f-41cd-9a52-1e200c525c84"
},
"custom": {
},
"description": "Test deployments",
"name": "test_v4_dep_online_space_hardware_spec",
"online": {
},
"space": {
"href": "/v4/spaces/f2ddb8ce-7b10-4846-9ab0-62454a449802",
"id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
},
"space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802",
"status": {
"online_url": {
"url": "https://example.com/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83/predictions"
},
"state": "updating"
}
},
"metadata": {
"created_at": "2020-06-08T16:51:08.315Z",
"description": "Test deployments",
"guid": "349dc1f7-9452-491b-8aa4-0777f784bd83",
"href": "/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83",
"id": "349dc1f7-9452-491b-8aa4-0777f784bd83",
"modified_at": "2020-06-08T16:55:28.348Z",
"name": "test_v4_dep_online_space_hardware_spec",
"parent": {
"href": ""
},
"space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
}
}
Hinweise:
Verwenden Sie
"add"
,"remove"
oder"replace"
für<operation type>
.Der Anfangsstatus für die Ausgabe der API 'PATCH' lautet 'updating' (wird aktualisiert). Fragen Sie den Status so lange ab, bis er sich in 'ready' (bereit) ändert. Rufen Sie dann die Bereitstellungsmetadaten ab.
Für den Asset-Patch kann nur das Attribut
ASSET
angegeben werden. Das Ändern anderer Attribute führt zu einem Fehler.Das Schema des aktuellen Modells und des Modells, das korrigiert wird, werden mit dem implementierten Asset verglichen. In der Ausgabe der Patch-Anforderungs-API wird eine Warnung zurückgegeben, wenn die beiden nicht übereinstimmen. Wenn beispielsweise eine Abweichung festgestellt wird, finden Sie diese Informationen in der Ausgabeantwort.
"status": { "message": { "text": "The input schema of the asset being patched does not match with the currently deployed asset. Please ensure that the score payloads are up to date as per the asset being patched." },
Weitere Informationen finden Sie unter Softwarespezifikationen mithilfe der API aktualisieren.
Übergeordnetes Thema: Vorhersagebereitstellungen verwalten