# Erstellen einer Spezifikation

Availability-note[Beta](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-beta)

Beta-Inhalt

In diesem Szenario verwenden Sie Talend-APIs zum Erstellen einer Spezifikation, um die Projektqualität zu verbessern.

## Warum und wann dieser Vorgang ausgeführt wird

Im Folgenden finden Sie einige Informationen zum API-Aufruf:

```
Method: POST
endpoint: api/v1/projects/quality/specifications
payload:[
  {
    "name": "string",
    "description": "string",
    "rules": [
      "string"
    ],
    "threshold": {
      "operator": "string",
      "value": 0,
      "type": "Percentage"
    }
  }
]
```

![Ausgewählte API zum Abrufen aller Spezifikationen.](https://help.qlik.com/Resources/Images/qlik-talend-cloud-migration-toolkit-user-guide/tcmp-specs-api.png)

## Prozedur

1. Rufen Sie den Endpunkt GET /api/v1/projects/quality/rules auf, um alle Regeln abzurufen.
2. Notieren Sie sich die IDs der Regeln, die Sie der zu erstellenden neuen Spezifikation hinzufügen möchten.
3. Rufen Sie den Endpunkt POST /api/v1/projects/quality/specifications auf, um eine Spezifikation zu erstellen.
4. Geben Sie im Bereich Body folgende Informationen ein:
   | Parametername | Wert |
   | --- | --- |
   | name | Geben Sie den Namen der Regel ein. |
   | description | Geben Sie die Beschreibung der Regel ein. |
   | rules | Geben Sie eine oder mehrere Regel-IDs ein. |
   | operator | Wählen Sie einen Vergleichsoperator für den Vergleich mit dem Schwellenwert aus: <=, \>=, =, \>= |
   | value | Geben Sie einen Wert für den Schwellenwert ein. Dieser Wert legt eine Grenze fest. Ober- oder unterhalb dieser Grenze muss eine Bedingung erfüllt sein. Dieses Feld akzeptiert numerische Werte ab 0. |
   | type | Geben Sie einen der folgenden Schwellenwerttypen ein: Percentage (Prozentsatz) oder Numeric (Numerisch). |

   Beispiel:
   ```
   {
     "name": "cloud-migration", 
     "description": "This specification contains rules related best practices for Talend Cloud Migration", 
     "rules": [
         "30599ac4-09b0-4abd", "30599ac4-09b0-4abc" 
         ], 
         "threshold": {
             "operator": "=", 
             "value": 0, 
             "type": "PERCENTAGE" 
          }
   }
   ```
5. Klicken Sie auf Execute (Ausführen), um den Aufruf auszugeben.

## Ergebnisse

Die Spezifikation ist erstellt.